citadel-mcp

Citadel MCP

AI コーディングエージェントに、スタックごとに厳選したドキュメントを型付きツールとして提供する Code Mode MCP サーバーです。

Citadel は、フォークしてカスタマイズすることを前提に構築されています。ホスト版パッケージには、スタックの小規模なスターターセットが含まれていますが、本当の価値は、エージェントが実際に必要とするドキュメントをパッケージ化することで生まれます。各スタックは小さなモジュールなので、追加のほとんどは機械的な作業です。

はじめに

要件

• Node.js v20.19、またはそれより新しい最新のメンテナンス LTSバージョン
• npm または pnpm

add-mcp でインストールする

すべてのコーディングエージェントに MCP サーバーをインストールします。

npx add-mcp citadel-mcp@latest

確認プロンプトを省略し、プロジェクトディレクトリ内で使用中の、検出されたすべてのエージェントにインストールするには、-y を追加します。すべてのプロジェクトにグローバルインストールするには、-g を追加します。

手動インストール

次の設定を MCP クライアントに追加します。

{
  "mcpServers": {
    "citadel": {
      "command": "npx",
      "args": ["-y", "citadel-mcp@latest"]
    }
  }
}

メモ

citadel-mcp@latest を使用すると、MCP クライアントで常に最新バージョンの Citadel MCP サーバーが使用されます。

MCP クライアントの設定

amp mcp add citadel -- npx citadel-mcp@latest

claude mcp add -s user citadel -- npx -y citadel-mcp@latest

codex mcp add citadel -- npx citadel-mcp@latest

gemini mcp add citadel npx citadel-mcp@latest

gemini mcp add -s user citadel npx citadel-mcp@latest

code --add-mcp '{"name":"citadel","command":"npx","args":["-y","citadel-mcp@latest"]}'

最初から利用できる内容

ホスト版パッケージには、すぐに試せるスタックのスターターセットが含まれています。

• Next.js（App Router、Next.js 16）
• React
• Turborepo
• Supabase ガイド

このリストは意図的に小さくしています。最良の結果を得るには、このリポジトリをフォークして、エージェントが必要とするスタックを追加してください — 社内ライブラリ、実際に使用しているフレームワークのバージョン、または機械可読な Markdown を公開しているドキュメントサイトなどです。docs/adding-a-docs-tool.md を参照してください。

仕組み

Citadel は Code Mode サーバーです。ドキュメントソースごとにツールを1つずつアドバタイズするのではなく、単一の docs ツールをアドバタイズします。エージェントは各ターンで codemode.<stack>_docs(...) と codemode.<stack>_index() を直接呼び出す async () => { ... } を1つ記述し、サーバーはそのコードをローカルの Node サンドボックスで実行します。N 回のドキュメント取得を1回の往復にまとめられます。

各スタックは、サンドボックス SDK に呼び出し可能なツールを2つ提供します。

• <stack>_index() — エージェントが有効なパスを選べるよう、ドキュメントのインデックスを返します
• <stack>_docs({ path }) — 指定されたドキュメントを Markdown として取得します

Citadel は、スタックをまたいだランキング付き検索も提供します。codemode.docs_search({ query, stacks?, fetch: true }) は、Markdown コンテンツを添付した BM25 ランキングの一致結果を1回の呼び出しで返します。

ドキュメント

• AI エージェントとして Citadel を使用する — docs ツールのプレイブックです。実行時には MCP リソース citadel://docs/agent-usage として提供されます。SDK リファレンス、並列ファンアウト、エラー処理、実例が含まれています。
• docs ツールを追加する — 新しいスタックを <stack>_index と <stack>_docs としてパッケージ化します。

ローカル開発

開発用に MCP サーバーをローカルで実行するには、次の手順に従います。

1. リポジトリをクローンします。

2. インストールしてビルドします。

   pnpm install
   pnpm build
   

3. MCP クライアントでローカル版を使用するように設定します。

   {
     "mcpServers": {
       "citadel-dev": {
         "command": "node",
         "args": ["/absolute/path/to/citadel-mcp/dist/index.js"]
       }
     }
   }
   

   または、Claude Code CLI を使用します。

   claude mcp add -s user citadel-dev -- node /absolute/path/to/citadel-mcp/dist/index.js
   

自動リロードを有効にして開発する場合は、代わりに MCP クライアントが tsx と src エントリを使用するように設定します。

claude mcp add -s user citadel-dev -- npx tsx /absolute/path/to/citadel-mcp/src/index.ts

ライセンス

MIT