sougou-connectors 使い方 ガイド

Claude / ChatGPT / Gemini その他 の LLM で 使う 方法 · 2026-09-01 藤本 伸樹 (Rei-AIOS)
449 本 の コネクタツール (sougou-connectors 446 + sougou-external 3) を あなた の 使っている LLM で 使う ための ガイドです。
本 page は 「URL 集」 と 「各 LLM 環境別 使い方」 を 分けて 記載。 友人・同僚 に 渡す 時 は 第 4 部 の コピペ用 サマリ が 便利です。 note 記事 (概要) は nifty_godwit2635 に。

第 1 部: URL 集 (bookmark 用)

主要 URL

用途URL
総目録 page (全 系統 の 見取り図)/tools/connector-inventory/
sougou-connectors README (使い方 一次資料)GitHub README
446 項目 索引 INDEX.mdGitHub INDEX
catalog.json (項目構造化 データ)GitHub catalog
sougou-external READMEGitHub external
note 記事 (概要)nifty_godwit2635 (2026-09-01 更新)

直接 データ (LLM に 貼付 用 raw URL)

データ直 URL
catalog.json 全 446 項目 (79 KB)raw catalog.json
README.mdraw README.md

補助 URL

第 2 部: LLM 環境別 使い方

大前提: sougou-connectors は MCP プロトコル (JSON-RPC 2.0 over stdio) の コネクタ。 MCP を ネイティブ 対応 しているのは Claude Desktop / Claude Code / Cursor の 3 種。 それ以外 (ChatGPT / Gemini / ローカル LLM 等) は 代替 方法 で 使います。

A. Claude Desktop で 使う (最も 簡単)

必要: Python 3.9+、 Claude Desktop アプリ

  1. リポジトリ を clone:
    git clone https://github.com/fc0web/rei-aios.git
    cd rei-aios/tools/sougou-connectors
  2. 使いたい 章 だけ 設定 生成 (全 446 本 だと 起動 重い):
    # 例: 第 6 章 理論 の 31 本 だけ
    python3 make_config.py --chapter 06
    
    # 例: 特定 の 3 項目 だけ
    python3 make_config.py --ids 164 276 399
  3. 生成された config.jsonmcpServers を、 Claude Desktop 設定 file に 貼付:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  4. Claude Desktop を 再起動
  5. 会話 で 「sougou-276-mosfet の info を 呼んで」 のように 指示

B. Claude Code (CLI) で 使う

Claude Desktop と 同じ手順 で config.json を 生成、 これ を rei-aios の .mcp.json に merge:

cd /path/to/rei-aios
python3 tools/sougou-connectors/make_config.py --chapter 10  # 回路 52 本
# 生成 config.json の mcpServers を .mcp.json に merge

Claude Code 起動時 に 自動 wire、 tools/list で 呼び出し可能。

C. ChatGPT (Web / API) で 使う

現状: ChatGPT は MCP 非対応。 3 つ の 代替:

C-1: Custom GPT + Actions (OpenAPI wrapper 経由)

Flask / FastAPI で 20-30 行 の REST wrapper を 書き、 ホスティング (Cloudflare Workers / Fly.io 等) して OpenAPI schema を Custom GPT の Actions に 登録。 未実装、 実装は 各自:

from fastapi import FastAPI
import subprocess

app = FastAPI()

@app.get("/connector/{connector_id}/{tool}")
def call_connector(connector_id: str, tool: str, q: str = ""):
    args = ["python3", f"connectors/{connector_id}.py", tool]
    if q:
        args.append(q)
    result = subprocess.run(args, capture_output=True, text=True)
    return {"output": result.stdout}

C-2: catalog.json を 直接 会話 に 貼る (最も 手軽) ★推奨

ChatGPT に こう 貼る だけ:

以下は Rei-AIOS の sougou-connectors catalog.json の 「東洋哲学」 項目 です:

{
  "id": "109",
  "term": "東洋哲学",
  "chapter_no": "05",
  "chapter": "哲学",
  "group": "地域・伝統別",
  "part_label": "第I部 学問・教育"
}

この 情報 を 前提 に、 東洋哲学 の 第 5 章 哲学 に おける
位置付け を 議論 してください。

catalog.json 全体 (79 KB) を 会話 冒頭 に 貼れば、 ChatGPT が 「search」 相当 の 動作 を 自力 で 行える (Sonnet / GPT-4 / Gemini Pro の context 内 に 収まる)。

C-3: Python 実行 → 出力 貼付

コマンド 実行 環境 (ローカル / Google Colab) が ある なら:

python3 connectors/276_mosfet.py info
# → 出力 を copy して ChatGPT に paste

D. Google Gemini で 使う

現状: Gemini も MCP 非対応。 3 方法:

D-1: Gemini API の Function Calling

from google import genai

tools = [{
    "function_declarations": [{
        "name": "sougou_info",
        "description": "sougou-connectors 446 項目 の 1 項目 の 所属・分類 を 返す",
        "parameters": {
            "type": "object",
            "properties": {
                "connector_id": {"type": "string", "description": "3 桁 の 項目 ID"}
            },
            "required": ["connector_id"]
        }
    }, {
        "name": "sougou_search",
        "description": "全 446 項目 を キーワード で 検索",
        "parameters": {
            "type": "object",
            "properties": {"query": {"type": "string"}},
            "required": ["query"]
        }
    }]
}]

# Function call を 受け取ったら subprocess で sougou-connectors 呼び 結果 返す

D-2: Google AI Studio で catalog.json 貼付

C-2 と 同じ pattern。 AI Studio の system instruction に catalog.json を 貼付。

D-3: Colab / Cloud Run で REST wrapper

C-1 と 同じ pattern を Google Cloud Run に deploy、 Gemini 側 から HTTPS 呼び出し。

E. その他 の LLM (Ollama / llama.cpp / API 直接)

E-1: 標準 出力 経由 (最も 汎用)

python3 connectors/276_mosfet.py info
# → 標準 出力 を LLM の context に 直接 挿入

E-2: 埋め込み script (RAG 系)

catalog.json 全 446 項目 を 埋め込み vector に 変換 して RAG に:

from langchain.document_loaders import JSONLoader
from langchain.embeddings import OllamaEmbeddings

loader = JSONLoader(
    file_path='catalog.json',
    jq_schema='.items[]',
    text_content=False
)
docs = loader.load()  # 446 documents

E-3: MCP-to-HTTP proxy (実験的)

コミュニティ の mcp-proxy 等 で stdio MCP を HTTP に 変換 可能。 stable ではない。

第 3 部: よく ある 質問

Q1. 「446 本 全部 入れないと 検索 できないか?」

A: 違います。 1 本 だけ 入れて も search は 全 446 項目 を 引ける よう に 設計。 まず 1 本 (例: 276_mosfet.py) を 入れて 全体 検索 動作 を 見る、 が 推奨 pattern。

Q2. Windows で 動かない (文字化け / encode error)

A: 2026-08-20 hotfix で 修正済み。 最新 版 を pull。 sougou_core.pyserve() 冒頭 で stdio を UTF-8 に 固定 (Windows の 既定 cp932 で 等 encode 失敗 対応)。

Q3. 「疎通確認 済み」 は 本当か?

python3 run_all_tests.py          # 代表 5 本 + 構文 + コア機能
python3 run_all_tests.py --full   # 446 本 すべて 実際 起動 (約 10 秒)

--full446 × 4 = 1,784 呼び出し が 例外 なく 応答 を verify。

Q4. 「新 項目 を 追加したい」

A: catalog.json に entry 追加 (コード 側 触らない)。 番号 447 以降 の 空き ID。 追加後、 該当 章 の count を 一覧記載 と 一致。 CLAUDE.md 181-208 行 の 「新規制作物 保存先 判定 rule」 に 従い memory + sougou 両方 に 記録。

Q5. 「外部 API (arXiv、 CiNii 等) を 実際 に 叩けるように したい」

A: sougou-connectors 本体 は 意図的 に 「照会・一覧・検索 のみ、 外部 API 叩かない」 設計。 外部 API 疎通 が 必要 なら sougou-external-connectors 3 本 (jp_academic / philosophy / sat) 参考 に 拡張。 sougou_core.py に tool 1 つ 追加 すれば 446 本 全部 に 同時 反映。

Q6. 「MCP 未対応 LLM で 使いたい けど wrapper 実装 が 面倒」

A: 一番 手軽 は catalog.json 全体 を 会話 冒頭 に 貼る (方法 C-2 / D-2)。 79 KB なので Sonnet / GPT-4 / Gemini Pro の context 内。 LLM 側 が 「文字列 検索 相当」 を 自力 で 行う ので 実装 ゼロ。

Q7. 「ライセンス は?」

A: AGPL-3.0 + Commercial (Dual License、 rei-aios 全体 と 同じ)。 個人 学習・研究 は AGPL-3.0 で 自由。 商用 は note nifty_godwit2635 の 藤本 まで 相談。

第 4 部: ユーザー への 一枚 サマリ (コピペ 用)

Rei-AIOS sougou-connectors — 学問・技術 全 446 項目 を LLM で 引ける MCP コネクタ集

使い方 詳細: rei-aios.pages.dev/tools/sougou-connectors-usage-guide/

ライセンス: AGPL-3.0 + Commercial (個人 学習 は 自由、 商用 は note へ)

Honest scope

  1. ChatGPT / Gemini の REST wrapper は 現在 未実装 — 方法 C-1 / D-3 は 目安 のみ、 動く 実装 は 提供 されていない
  2. MCP-to-HTTP proxy (方法 E-3) は コミュニティ 実装 段階、 stable ではない
  3. catalog.json 79 KB は Sonnet / GPT-4 / Gemini Pro の context に 収まる が、 廉価 モデル (GPT-3.5、 Gemini Nano) では 超過 可能性
  4. Windows hotfix は 2026-08-20 版 — それ以前 clone は pull し直し
  5. 446 本 疎通 verify は README claim に 依存、 独立 再検証 は python3 run_all_tests.py --full、 現在 藤本 未実施