MCP Docs Server

🚀 MCP Docs Server

MCP Docs Serverは、Model Context Protocol (MCP) のドキュメントを検索するためのサーバーです。公式のMCP SDKを使用してTypeScriptで構築されています。

✨ 主な機能

• BM25検索 - Porterステミングを使用したBM25アルゴリズムによる高品質なランク付き検索
• 高速起動 - 起動時にドキュメントのタイトルをインデックス化し、コンテンツは必要に応じて取得
• Markdown対応 - ヘッダー、コードブロック、リンクに重み付けを行い、関連性を向上
• stdioトランスポート - ローカルプロセスとして実行され、簡単に統合できる

📦 インストール

クイックスタート (推奨)

MCPクライアントの設定 (Claude Desktop、Kiroなど) に追加します。

{
  "mcpServers": {
    "mcp-docs-server": {
      "command": "npx",
      "args": ["-y", "@praveenc/mcp-docs-server"]
    }
  }
}

これだけです！サーバーは自動的にダウンロードされ、実行されます。

グローバルインストール

npm install -g @praveenc/mcp-docs-server

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

{
  "mcpServers": {
    "mcp-docs-server": {
      "command": "mcp-docs-server"
    }
  }
}

📚 ドキュメント

search_mcp_docs

ランク付けされた結果でMCPプロトコルのドキュメントを検索します。

パラメータ:

• query (文字列、必須): 検索クエリ文字列
• k (数値、オプション): 返す最大結果数 (デフォルト: 5)。一致するドキュメントが少ない場合は、少ない結果が返されます。

例:

{
  "query": "transports",
  "k": 5
}

戻り値:

[
  {
    "url": "https://modelcontextprotocol.io/specification/2025-11-25/basic/transports.md",
    "title": "Transports",
    "score": 15.725,
    "snippet": "MCP uses JSON-RPC to encode messages..."
  }
]

fetch_mcp_doc

URLから完全なドキュメントコンテンツを取得します。

パラメータ:

• uri (文字列、必須): modelcontextprotocol.ioのドキュメントURL

例:

{
  "uri": "https://modelcontextprotocol.io/specification/2025-11-25/server/tools.md"
}

戻り値:

{
  "url": "https://modelcontextprotocol.io/specification/2025-11-25/server/tools.md",
  "title": "Tools",
  "content": "# Tools\n\nTools enable servers to expose executable functionality..."
}

🔧 テスト (MCP Inspectorを使用)

npx @modelcontextprotocol/inspector npx -y @praveenc/mcp-docs-server

🔨 開発

ローカル開発用にリポジトリをクローンします。

git clone https://github.com/praveenc/mcp-docs-server.git
cd mcp-docs-server
npm install

コマンド

# 開発モードで実行
npm run dev

# テストを実行
npm test

# 型チェック
npm run typecheck

# ビルド
npm run build

# MCP Inspectorでテスト (開発用)
npm run inspect:dev

ローカルMCPクライアント設定 (開発用)

{
  "mcpServers": {
    "mcp-docs-server": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-docs-server/src/index.ts"]
    }
  }
}

🏗️ アーキテクチャ

src/
├── index.ts          # MCPサーバーのエントリポイント
├── config.ts         # 設定
├── tools/
│   └── docs.ts       # search_mcp_docs, fetch_mcp_doc
└── utils/
    ├── cache.ts      # ドキュメントキャッシュ
    ├── doc-fetcher.ts # HTTPフェッチとHTMLパース
    ├── indexer.ts    # BM25検索インデックス
    ├── logger.ts     # ロギングユーティリティ
    ├── stopwords.ts  # ストップワードリスト
    ├── text-processor.ts # テキストユーティリティ
    └── url-validator.ts  # URL検証

🔍 検索アルゴリズム

検索には、以下の機能を持つBM25 (Best Matching 25) が使用されています。

• Porterステミング - 単語の変形を一致させます (例: "running" → "run")
• バイグラム - フレーズの一致をキャプチャします (例: "tool input")
• 重み付けスコアリング:
  • タイトルの一致: 3 - 8倍のブースト
  • ヘッダーの一致: 4倍の重み
  • コードブロック: 2倍の重み
  • リンクテキスト: 2倍の重み
• ドメイン用語の保持 - "mcp"、"json"、"stdio" などの技術用語はステミングされません

📄 ライセンス

MIT