目的
MCP tool surface を 4 → 1 に収束する。ハイブリッド検索 (BGE-M3 dense + BM25 sparse + cross-encoder reranker) を単一エントリポイントに据え、周辺 3 tool (get_doc_content / get_issue_context / list_recent_activity) は search_issues の拡張として折り畳む or 廃止する。
前提 (検証済み 2026-04-23)
src/mcp.ts literal 読み結果:
- search_issues (L87): hybrid search core。Vectorize + D1 FTS5 + reranker。類機能なし、必須
- get_issue_context (L567): live GitHub API (単一 issue 集約)。search とは独立の live 叩き
- get_doc_content (L813): GitHub contents API で raw .md 取得
- list_recent_activity (L927): IssueStore の時間窓 query
解析結果 (「search だけで成立するか」):
| 既存 tool |
search 単独で成立 |
取り扱い |
| list_recent_activity |
◎ 退化ケース (空 query + time sort) |
削除、search の拡張に吸収 |
| get_doc_content |
◯ inline content return で吸収可 |
削除、search の include_content option に吸収 |
| get_issue_context |
△ live data の喪失 |
削除 (許容)。stale snapshot で十分な用途が大半、live は gh / webhook MCP で補填 |
制約
機能制約
search_issues の API 拡張:
query を optional に (空 query = time-ordered scan mode)sort 追加: "relevance" (default) / "updated_desc" / "created_desc"include_content 追加: type=doc 結果の raw content を inline 返却 (default false)since / until 追加: 時間窓フィルタ (activity scan 用)- 既存の
type / repo / state / labels / milestone / assignee / fusion / rerank / top_k params は保持
削除対象:
get_doc_content tool 登録と handlerget_issue_context tool 登録と handlerlist_recent_activity tool 登録と handler
Proxy 側更新
mcp-server/server/index.js の stdio 側 tool schema が Worker 側の変更に合わせて同期される必要あり:
- 削除: get_doc_content / get_issue_context / list_recent_activity の stdio schema
- 更新: search_issues の schema に新 params 反映
Docs 更新
README.md / README.ja.md の tool 一覧を 1 tool 表記に改修- search_issues の使い方 (空 query / include_content / since 等) を追記
- 削除 tool の記述を全て除去
バージョン / リリース
- minor release (v0.8.0) — tool 面の破壊的変更
- 現行クライアント (Claude Code / Claude Desktop) は MCP 再接続で新 tool list を読み直す (通常の再起動で解決)
Target files
src/mcp.ts — tool 登録 4 → 1、search_issues 拡張実装mcp-server/server/index.js — proxy 側 stdio schema 同期README.md — tool 一覧更新README.ja.md — tool 一覧更新
範囲
minor (tool surface の user/system observable な破壊的変更)
関連
目的
MCP tool surface を 4 → 1 に収束する。ハイブリッド検索 (BGE-M3 dense + BM25 sparse + cross-encoder reranker) を単一エントリポイントに据え、周辺 3 tool (get_doc_content / get_issue_context / list_recent_activity) は search_issues の拡張として折り畳む or 廃止する。
前提 (検証済み 2026-04-23)
src/mcp.ts literal 読み結果:
解析結果 (「search だけで成立するか」):
制約
機能制約
search_issues の API 拡張:
queryを optional に (空 query = time-ordered scan mode)sort追加:"relevance"(default) /"updated_desc"/"created_desc"include_content追加: type=doc 結果の raw content を inline 返却 (default false)since/until追加: 時間窓フィルタ (activity scan 用)type/repo/state/labels/milestone/assignee/fusion/rerank/top_kparams は保持削除対象:
get_doc_contenttool 登録と handlerget_issue_contexttool 登録と handlerlist_recent_activitytool 登録と handlerProxy 側更新
mcp-server/server/index.jsの stdio 側 tool schema が Worker 側の変更に合わせて同期される必要あり:Docs 更新
README.md/README.ja.mdの tool 一覧を 1 tool 表記に改修バージョン / リリース
Target files
src/mcp.ts— tool 登録 4 → 1、search_issues 拡張実装mcp-server/server/index.js— proxy 側 stdio schema 同期README.md— tool 一覧更新README.ja.md— tool 一覧更新範囲
minor (tool surface の user/system observable な破壊的変更)
関連