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 的标准错误输出以查看错误信息。
• 调试日志会显示重试尝试信息。