Rust Docs

🚀 MCP Rust ドキュメントサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を使用して、Rust crateのドキュメントを取得し、LLMがRustコードを処理する際に必要なコンテキスト情報を提供します。

✨ 主な機能

• docs.rs上で利用可能な任意のRust crateのドキュメントを取得する。
• HTMLを削除し、内容を読みやすい形式に整形する。
• 応答サイズを制限して、クライアントが過負荷にならないようにする。
• 最新バージョンのMCP SDK（v1.6.1）を使用する。

📦 インストール

前提条件

• Node.js
• npm

# リポジトリをクローンする
git clone https://github.com/0xKoda/mcp-rust-docs.git
cd mcp-rust-docs

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

💻 使用例

基本的な使用法

# サーバーを直接起動する
npm start

AIアシスタントとの統合

Claude Desktop

Claude Desktopの設定ファイル（claude_desktop_config.json）に以下の内容を追加します。

{
  "mcpServers": {
    "rust-docs": {
      "command": "node",
      "args": ["/absolute/path/to/index.js"]
    }
  }
}

/absolute/path/to/index.jsをこのリポジトリ内のindex.jsファイルの絶対パスに置き換えてください。

サンプルの使用方法

サーバーが起動し、AIアシスタントが設定されたら、以下のような質問をすることができます。

• “‘tokio’ crateのドキュメントを探す”
• “‘serde’ crateはどのような機能を提供していますか？”
• “‘ratatui’のドキュメントを表示する”
• “‘axum’ crateの主要なモジュールを説明できますか？” AIはlookup_crate_docsツールを使用して関連するドキュメントを取得し、表示します。

MCP Inspectorを使用したテスト

以下のコマンドを実行して、このサーバーをテストすることができます。

npx @modelcontextprotocol/inspector

その後、「ローカルサーバーに接続する」オプションを選択し、指示に従って操作します。

🔧 技術詳細

動作原理

このサーバーは、lookup_crate_docsという単一のMCPツールを実装しており、以下の手順で動作します。

1. Rust crate名を入力として受け取ります（オプション。指定されない場合はデフォルトで「tokio」になります）。
2. docs.rsからドキュメントを取得します。
3. html-to-textライブラリを使用して、HTMLを純粋なテキストに変換します。
4. 内容が8000文字を超える場合は、切り捨てます。
5. 整形されたドキュメントを正しいMCP応答形式で返します。

SDK実装に関する注意事項

このサーバーは、精心構築されたインポートパスを持つMCP SDKを使用しています。コードを変更する場合は、以下の点に注意してください。

1. SDKは特定のパスからインポートする必要があります（例：@modelcontextprotocol/sdk/server/mcp.js）。
2. 低レベルのツールではなく、高レベルのMcpServer APIを使用しています。
3. ツール定義では、Zodを使用してパラメーターを検証しています。
4. コンソール出力をstderrにリダイレクトして、MCPプロトコルを破壊しないようにしています。
5. ツールは正しいMCP応答オブジェクトを返します。

📄 ライセンス

MIT