Pitlane MCP

皮特兰mcp

用于AI编码代理的令牌高效代码智能MCP服务器。

pitlane-mcp 使用树状图索引一次代码库，让代理检索他们实际需要的符号，而不是将整个文件转储到上下文中。

项目状态

pitlane-mcp 功能齐全，目前处于维护模式。新的主要功能没有积极规划。仍然欢迎Bug修复、兼容性更新、文档改进和重点贡献。

为什么

AI编码代理倾向于过度阅读。 pitlane-mcp 为他们提供了一个较小的导航界面和符号级别读数，以便他们可以：

• 索引代码一次
• 发现正确的符号或文件
• 阅读最小的有用单位
• 跟踪执行路径和变更影响

在这个仓库中的基准语料库上，这转化为快速占用空间的大幅减少，通常减少一到两个数量级，同时保持导航以代码库为基础。

它做什么

• 基于AST的索引，适用于Rust、Python、JavaScript、TypeScript、Svelte、C、C++、Go、Java、C#、Ruby、Swift、Objective-C、PHP、Zig、Kotlin、Lua、Solidity和Bash
• BM25符号搜索加可选语义搜索
• 代理的默认MCP表面较小
• 用于发现、读取、路径跟踪和影响分析的复合导航工具
• 增量重新索引和磁盘持久化索引
• 完全本地操作，无需外部服务

安装

从下载预构建的二进制文件 适用于Linux、macOS和Windows。

或者通过Homebrew安装：

brew tap eresende/pitlane-mcp
brew install pitlane-mcp

或通过安装 cargo-binstall:

cargo binstall pitlane-mcp

或者从crates.io安装：

cargo install pitlane-mcp

或者从源代码构建：

cargo build --release
cp target/release/pitlane-mcp ~/.local/bin/
cp target/release/pitlane ~/.local/bin/

快速入门

克劳德代码

claude mcp add pitlane-mcp -- pitlane-mcp

开源代码

添加 opencode.json 或 opencode.jsonc:

{
  "mcp": {
    "pitlane-mcp": {
      "type": "local",
      "command": ["pitlane-mcp"]
    }
  }
}

VS Code

添加 .vscode/mcp.json:

可选语义搜索变量位于 env.

{
  "mcp": {
    "servers": {
      "pitlane-mcp": {
        "type": "stdio",
        "command": "pitlane-mcp",
        "args": [],
        "env": {}
      }
    }
  }
}

光标/Kiro IDE

添加 .cursor/mcp.json 或 .kiro/settings/mcp.json:

可选语义搜索变量位于 env.

{
  "mcpServers": {
    "pitlane-mcp": {
      "type": "stdio",
      "command": "pitlane-mcp",
      "args": [],
      "env": {}
    }
  }
}

默认工作流

大多数用户应保留默认工具层：

1. 呼叫 ensure_project_ready 一旦启动。它确保索引存在并报告嵌入是否仍在运行，但不会阻止嵌入。
2. 使用 investigate 首先是广泛的代码问题，如子系统、行为和执行路径问题。
3. 使用 locate_code 当你需要在没有完整来源的情况下进行发现时。
4. 使用 read_code_unit 一旦你知道目标。
5. 使用 trace_path 用于接收显式源代码或配置以实现问题。
6. 使用 analyze_impact 在编辑或重构之前。
7. 使用 search_content 只有当你知道一个文本片段，但不知道所属的符号时。

默认公共层：

• ensure_project_ready
• investigate
• locate_code
• read_code_unit
• trace_path
• analyze_impact
• get_index_stats
• search_content

高级图元被隐藏 tools/list 默认情况下。集 PITLANE_MCP_TOOL_TIER=all 以暴露整个表面。

文档

• 文档索引
• 工具参考
• 代理商指导
• 语言和符号种类
• 基准测试
• 安全
• 语义搜索
• 基准线束

命令行界面

这 pitlane 二进制在MCP外部暴露了相同的代码智能。

示例：

pitlane index /your/project
pitlane investigate /your/project "How does ignore handling work?"
pitlane search /your/project authenticate --kind method
pitlane symbol /your/project src/auth.rs::Auth::login[method]
pitlane usages /your/project src/auth.rs::Auth::login[method]

所有命令都将JSON输出到stdout。日志将转到stderr并由以下方式控制 RUST_LOG.

支持的语言

pitlane-mcp 支持Rust、Python、JavaScript、TypeScript、Svelte、C、C++、Go、Java、C#、Bash、Ruby、Swift、Objective-C、PHP、Zig、Lua、Kotlin和Solidity。

有关完整的扩展矩阵和符号类型覆盖率，请参阅 语言和符号种类.

备注

• pitlane-mcp 功能完整，并作为OSS导航工具进行维护。
• 此仓库中的基准数字是特定于版本的快照，而不是对每个代理工具或模型的保证。

许可证

根据以下任一许可 MIT许可证 或 Apache许可证，版本2.0，由您选择。