Documentation Hub MCP Server

🚀 ドキュメント知識ベース MCP サーバー

このサーバーは、複数の技術分野にまたがる智能ドキュメント検索を提供する Model Context Protocol (MCP) サーバーです。様々な技術分野の質問に対して、適切なドキュメントを迅速に検索し提供することができます。

🚀 クイックスタート

この MCP サーバーは、技術的な質問に対して目的のドキュメントを検索するために開発されました。混合手法を用いて、質問の技術分野を特定し、特定のトピックを抽出し、正確なドキュメント URL を構築し、最も関連性の高いドキュメントを取得して返します。

✨ 主な機能

• 分野分類：質問が React、Node.js、Python、または一般的なトピックのどれに属するかを自動的に識別します。
• トピック抽出：正規表現パターンマッチングを使用して、質問内の特定の技術概念を識別します。
• URL 構築：識別されたトピックに基づいて、目的のドキュメント URL を構築します。
• 複数のドキュメントソースのサポート：React、Node.js、Python のドキュメントをサポートし、他の分野にも拡張可能です。
• 標準化されたインターフェース：Model Context Protocol を実装し、MCP 互換クライアントとの相互運用性を実現します。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/mcp-server.git
cd mcp-server

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

💻 使用例

基本的な使用法

サーバーの起動

node build/index.js

トピック抽出のテスト

このプロジェクトには、トピック抽出と URL 構築の仕組みを示すテストスクリプトが含まれています。

# テストスクリプトをコンパイルする
npx tsc src/test.ts --outDir build

# テストを実行する
node build/test.js

クライアントとの統合

サーバーは、任意の MCP 互換クライアントと統合できます。以下は、サンプルのクライアントコードです（このプロジェクトには含まれません）。

// サンプルのクライアントコード
const client = new McpClient();
const result = await client.callTool("fetch-documentation", {
  query: "如何在 React 中使用 useState 钩子？",
});

console.log(result);
// 出力:
// {
//   domain: "react-docs",
//   topics: ["useState", "state"],
//   specificUrl: "https://react.dev/reference/react/useState",
//   content: "...",
//   source: "https://react.dev/reference/react/useState"
// }

📚 ドキュメント

プロジェクト構造

• src/index.ts - メインサーバーの実装
• src/test.ts - トピック抽出と URL 構築のテストスクリプト
• build/ - コンパイルされた JavaScript 出力
• package.json - プロジェクトの設定と依存関係

利用可能なツール

determine-domain

質問がどの技術分野に属するかを判断します。

{
  query: string; // ユーザーが分類したい質問内容
}

戻り値:

{
  domain: string; // 識別された分野
  confidence: string; // "high" または "low"
}

extract-topics

指定された分野に基づいて、質問から特定のトピックを抽出します。

{
  query: string; // ユーザーが分析したい質問内容
  domain: string; // トピックを抽出する技術分野
}

戻り値:

{
  topics: string[]; // 識別されたトピックの配列
  count: number; // 見つかったトピックの数
}

fetch-documentation

質問と分野に基づいて、ドキュメントを取得します。

{
  query: string; // ユーザーの質問内容
  domain?: string; // 分野（オプション）
}

戻り値:

{
  "docs": [
    {
      "url": string,
      "content": string,
      "relevance": number
    }
  ],
  "timestamp": string,
  "status": "success" | "error"
}

利用可能なサービスリソース

• ドキュメントストレージ：技術ドキュメントの保存と検索に使用されます。
• トピックインデックス：関連するトピックのドキュメントを迅速に検索するために使用されます。
• URL ビルダー：質問に基づいて目的の URL を構築します。

拡張

新しい分野の追加

新しい技術分野（例えば、新しいドキュメントストレージ）を追加するには、以下の手順に従ってください。

1. データベースに新しいコレクションまたはテーブルを作成します。
2. extract-topics ツールを更新して、新しい分野のトピックを識別できるようにします。
3. 新しい機能をテストして、正常に動作することを確認します。

トピック抽出の改善

トピック抽出の精度を向上させるには、以下の方法を検討してください。

• より複雑な自然言語処理モデル（例えば、BERT）を使用する。
• トレーニングデータの量を増やす。
• 正規表現パターンを定期的に更新して最適化する。

📄 ライセンス

[ここにライセンス内容を挿入]

🤝 コントリビューションガイド

このプロジェクトへのコントリビューションを歓迎します！ 参加方法については、プロジェクトリポジトリ内の CONTRIBUTING.md ファイルを参照してください。