citesearch

citesearch

citesearchは、Edgepedia向けの小型クライアントです。Edgepediaは独立した百科事典コーパスで、リリースノートによると約486,000件の記事が収録されており、各記事には固有のIDとクレジット表記があります。コーパスを主題で検索したり、記事やトピックの全文を読んだり、既知の記事に関連する記事を一覧表示したり、2つの記事間にある本文中のリンクをたどったりできます。また、周辺の文脈を少し与えると、曖昧な名前がどの記事を指すかを特定できます。1つのバイナリで、コマンドラインインターフェースとstdio MCP サーバーの両方を提供します。

アカウントもAPIキーも必要ありません。内部では、どちらのインターフェースも各リクエストをホスト型Edgepediaエンドポイントのhttps://www.edgechat.ai/mcpに転送し、返されたテキストを出力します。記事にはクレジット表記が付いています。上流のテキストに含まれている場合は、返されたまま表示されます。記事のテキストを再利用する際は、必ずクレジット表記も付けてください。

インストール

npx @reneturcios/citesearch search koala

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/citesearch

コンテナーはデフォルトでMCP サーバーを起動します（以下を参照）。CLIとして使用するには、CLI引数を渡してください。

CLI

citesearch search Mount Fuji
citesearch fetch ep9kcz7eym
citesearch fetch ep9kcz7eym --no-citations
citesearch related ep9kcz7eym
citesearch connect epStart epTarget
citesearch resolve Jaguar --context "British car maker"

citesearch --version

結果はプレーンテキストで出力されます。検索では、該当する記事のID、タイトル、リンク、要約が返されます。取得では、リンク、日付、トピック、ライセンス、クレジット表記を含む記事がMarkdown形式で返されます。解決では、該当する記事と信頼度、代替候補が示されます。終了コード：成功時は0、上流へのリクエスト失敗時は1、使用方法のエラー時は2です。引数はリクエストを行う前に検証されます。

fetchに関する注意：引用を有効にした場合（デフォルト）、記事の出典はインラインリンクとして表示されます。--no-citationsを指定すると、代わりに[n]マーカーが使われ、テキストの長さは約4分の1短くなります。上流のドキュメントには、複数のIDをまとめて取得する方法、単一セクションの取得、トークン予算、該当する箇所のみの取得についても記載されていますが、それらの制御に使うパラメーター名は公開されていません。そのため、このクライアントでは独自に追加していません。fetchが受け取るのはID 1つと引用の切り替えだけです。

MCP サーバー

1つのバイナリでどちらのインターフェースも提供します。mcpサブコマンドはstdio MCP サーバーを起動します。

npx -y @reneturcios/citesearch mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "citesearch": {
      "command": "npx",
      "args": ["-y", "@reneturcios/citesearch", "mcp"]
    }
  }
}

ツール

5つのツールはいずれも読み取り専用で、キーは不要です。

ツール	入力	返される内容
search	query（文字列）—質問ではなく、主題の名前	該当する記事：ID、タイトル、リンク、要約（要約がない場合は記事の冒頭）。別名や誤記も機能し、トピックのフレーズを指定するとそのトピックが返されます。
fetch	id（文字列）、citations（ブール値、省略可）	リンク、日付、トピック、ライセンス、クレジット表記を含む記事をMarkdown形式で返します。トピックのIDを指定すると、そのトピックの記事が一覧表示されます。citations: falseを指定すると、インラインの出典リンクが[n]マーカーに置き換わります。
related	id（文字列）	関連記事：同じトピックの記事、隣接する各トピックからいくつかの記事、地理的に近い記事。
connect	from（文字列）、to（文字列）	ある記事から別の記事への、本文中のリンクをたどる最短経路（最大6ホップ）。各ホップをつなぐ文も含まれます。
resolve	name（文字列）、context（文字列、省略可）	その名前がどの記事を指すかを、信頼度と代替候補とともに返します。たとえば、「British car maker」のそばにある「Jaguar」は自動車会社を指し、「big cat」のそばにある場合は動物を指します。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch only)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSEを参照してください。（このライセンスが適用されるのはこのクライアントです。Edgepediaの記事テキストには独自のライセンスが適用され、固有のクレジット表記が付いています。）