Hexdocs MCP Server

🚀 HexDocs MCP サーバー

TypeScript で実装された Model Context Protocol (MCP) サーバーです。Hex パッケージのドキュメントに対して、セマンティック検索機能を提供します。このサーバーは、hexdocs_mcp Elixir パッケージによって生成された埋め込みデータとシームレスに統合され、Hex ドキュメントを AI アプリケーション内で簡単に検索できるようにします。

✨ 主な機能

• Hex パッケージのドキュメントを検索するための MCP 互換サーバー
• hexdocs_mcp で生成された埋め込みデータとの統合
• Model Context Protocol 標準に基づき、AI ツールと互換性がある
• npx を通じて迅速にインストールでき、簡単にセットアップできる
• カスタムデータベースパスの設定をサポート

📦 インストール

互換性要件

• Node.js 18 以上
• hexdocs_mcp で生成された SQLite データベースへのアクセスが必要です（必要なパッケージのデータを取得するには、mix hex.docs.mcp fetch PACKAGE を実行する必要があります）

📚 ドキュメント

設定

サーバーは hexdocs_mcp パッケージによって作成された SQLite データベースを探します。デフォルトでは、~/.hexdocs_mcp/hexdocs_mcp.db を使用しますが、カスタムパスを指定することもできます。

# 例：カスタムデータベースパスの設定
export HEXDOCS_MCP_PATH=/path/to/custom/directory

統合

サーバーは、Model Context Protocol をサポートする様々な AI ツールと統合できます。以下は Cursor の例です。 mcp.json ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "hexdocs-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "hexdocs-mcp-server"
      ]
    }
  }
}

ヒントとテクニック

エージェントとやり取りしているときに、特定のツールのドキュメントが不足していることに気づいた場合、AI に mix hex.docs.mcp fetch ... コマンドを実行させて、必要なデータを取得することができます。

🤝 貢献

貢献を歓迎します！自由にプルリクエストを送信してください。大きな変更については、まず問題を開いて、変更したい内容について議論してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。