Pathfinder

🚀 Pathfinder MCP

Pathfinder MCP 用於將 MCP 客戶端連接到 LSP 服務器，每個 Pathfinder 實例可處理一個 LSP 服務器。

🚀 快速開始

Pathfinder MCP 可幫助你輕鬆地將 MCP 客戶端與 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 返回空結果時，會自動重試 3 次，每次間隔 150 毫秒，以處理索引延遲問題。

更多使用示例

Python 搭配 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

📚 詳細文檔

故障排除

• 設置 LOG_LEVEL=debug 以查看 LSP 通信信息。
• LSP 超時時間為 15 秒。
• 檢查 LSP 的標準錯誤輸出以查看錯誤信息。
• 調試日誌會顯示重試嘗試信息。