Pathfinder

🚀 Pathfinder MCP

MCPクライアントをLSPサーバーに接続します。各Pathfinderインスタンスは1つのLSPサーバーを扱います。

🚀 クイックスタート

📦 インストール

cargo build --release

バイナリは target/release/pathfinder にあります。

💻 使用例

基本的な使用法

# 単一の拡張子
pathfinder -e py -s pyright-langserver -- --stdio

# 複数の拡張子
pathfinder -e py -e pyi -s uv run pyright-langserver -- --stdio

# ワークスペースを指定
pathfinder -e rs -s rust-analyzer -w /path/to/project

オプションの説明

• -e, --extension <EXT> - ファイル拡張子（ドットなし、複数指定可）
• -s, --server <CMD>... - LSPサーバーのコマンド
• -w, --workspace <PATH> - プロジェクトディレクトリ（デフォルト: カレントディレクトリ）

MCP設定

単一の言語

{
  "mcpServers": {
    "pathfinder-python": {
      "command": "/path/to/pathfinder",
      "args": ["-e", "py", "-s", "pyright-langserver", "--", "--stdio"]
    }
  }
}

複数の言語

別々のインスタンスを実行します。

{
  "mcpServers": {
    "pathfinder-rust": {
      "command": "/path/to/pathfinder",
      "args": ["-e", "rs", "-s", "rust-analyzer"]
    },
    "pathfinder-ts": {
      "command": "/path/to/pathfinder",
      "args": ["-e", "ts", "-e", "tsx", "-s", "typescript-language-server", "--", "--stdio"]
    }
  }
}

ツール

definition - LSPの textDocument/definition を使って定義元にジャンプします。

入力: { uri: string, line: number, character: number }

返り値: [{ uri, range }]

LSPが空の結果を返した場合、150msの遅延を挟んで自動的に3回リトライします（インデックス作成の遅延を処理します）。

トラブルシューティング

• LOG_LEVEL=debug を設定するとLSPの通信を確認できます。
• LSPのタイムアウト時間は15秒です。
• LSPの標準エラー出力を確認してエラーをチェックします。
• デバッグログにはリトライの試行回数が表示されます。

追加の使用例

# Python with uv
pathfinder -e py -e pyi -s uv run pyright-langserver -- --stdio

# TypeScript
pathfinder -e ts -e tsx -s typescript-language-server -- --stdio

# Rust
pathfinder -e rs -s rust-analyzer

# Go
pathfinder -e go -s gopls