HexDocs MCP Server

HexDocs MCP Server

Hex パッケージのドキュメントをセマンティック検索できる、Model Context Protocol（MCP）を実装した TypeScript サーバーです。hexdocs_mcp Elixir パッケージで生成された埋め込みデータとシームレスに連携し、AI アプリケーションから Hex のドキュメントを簡単に検索できます。

機能

• Hex パッケージのドキュメントを検索する MCP 互換サーバー
• hexdocs_mcp Elixir パッケージで生成された埋め込みデータと連携
• AI ツールとの互換性を実現する Model Context Protocol 標準に基づいて構築
• npx を使って簡単にインストールでき、すばやくセットアップ可能
• データベースパスをカスタマイズできるシンプルな設定

要件

• Node.js 18 以降
• hexdocs_mcp が生成した SQLite データベースへのアクセス（対象のパッケージで事前に mix hex.docs.mcp fetch PACKAGE を実行する必要があります）

設定

サーバーは hexdocs_mcp パッケージが作成した SQLite データベースを参照します。デフォルトでは ~/.hexdocs_mcp/hexdocs_mcp.db を使用しますが、カスタムパスも指定できます。

# Example: Set custom database path
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 ... コマンドを実行してもらえば、自分で実行する必要はありません。

コントリビューション

コントリビューションを歓迎します。お気軽に Pull Request を送信してください。大きな変更を加える場合は、まず issue を作成して、変更内容について話し合ってください。

このプロジェクトは MIT ライセンスのもとで公開されています。詳細については LICENSE ファイルをご覧ください。