皮特兰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": {}
}
}
}默认工作流
大多数用户应保留默认工具层：
- 呼叫
ensure_project_ready一旦启动。它确保索引存在并报告嵌入是否仍在运行，但不会阻止嵌入。 - 使用
investigate首先是广泛的代码问题，如子系统、行为和执行路径问题。 - 使用
locate_code当你需要在没有完整来源的情况下进行发现时。 - 使用
read_code_unit一旦你知道目标。 - 使用
trace_path用于接收显式源代码或配置以实现问题。 - 使用
analyze_impact在编辑或重构之前。 - 使用
search_content只有当你知道一个文本片段，但不知道所属的符号时。
默认公共层：
ensure_project_readyinvestigatelocate_coderead_code_unittrace_pathanalyze_impactget_index_statssearch_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，由您选择。