使用说明
工作区工具MCP服务器
Git支持的文件操作、提交、全文搜索和技能验证 敏捷大脑 代理人。该服务器为代理提供了一种结构化的方式来读取、写入和提交git存储库中的文件，查询索引知识库，以及验证技能清单。
这是为NimbleBrain的代理运行时提供动力的核心MCP服务器之一。它是开源的，因此您可以确切地看到代理可以做什么，将其分叉以添加自己的工具，或者将其用作构建工作区风格的MCP服务器的参考。
延伸
想要赋予代理新的功能吗？此服务器是添加在工作区（代理可以访问的git仓库）上操作的工具的正确位置。一些想法：
- 添加a
file_move或file_rename工具 - 添加a
git_diff显示未提交更改的工具 - 添加a
git_log显示提交历史记录的工具 - 将特定于域的查询操作添加到
index_query - 为您自己的文件格式添加验证工具
分叉此仓库，将您的工具添加到 src/mcp_workspace_tools/server.py，并部署您的自定义版本。
工具
file_read
按相对路径从存储库中读取文件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
path |
string |
是 | 回购相对文件路径 |
file_write
将内容写入文件。创建父目录并暂存文件以供提交。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
path |
string |
是 | 回购相对文件路径 |
content |
string |
是 | 要写入的文件内容 |
file_list
列出存储库中的跟踪文件，可选择按目录和glob模式进行筛选。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
directory |
string |
无 | 要筛选的目录前缀 |
pattern |
string |
文件名没有 | Glob模式（默认值： *) |
file_delete
删除文件并执行删除操作。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
path |
string |
是 | 回购相对文件路径 |
git_提交
使用给定消息提交所有阶段性更改。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
message |
string |
是 | 提交消息 |
索引查询
查询SQLite索引以进行全文搜索和实体解析。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
action |
string |
是 | 查询操作： search, resolve_entity, files_by_type, files_by_tag |
query |
string |
否 | 搜索查询或实体名称 |
entity_type |
string |
否 | 解析/筛选的实体类型 |
tag |
string |
无 | 文件标记_by_Tag |
limit |
integer |
否 | 最大结果（默认值：20） |
技能验证
根据模式验证技能清单YAML字符串。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
manifest_yaml |
string |
是 | 技能清单的完整YAML内容 |
配置
| 环境变量 | 必填 | 描述 |
|---|---|---|
REPO_PATH |
是 | git存储库根目录的路径 |
TENANT_ID |
否 | 租户标识符（默认为“默认”） |
发展
git clone https://github.com/NimbleBrainInc/mcp-workspace-tools.git
cd mcp-workspace-tools
# Install dependencies
uv sync --group dev
# Run all checks (format, lint, typecheck, tests)
make check
# Run the server locally (stdio)
uv run python -m mcp_workspace_tools.server
# Run the server locally (HTTP)
make run-http
许可证
麻省理工学院
