mcp_server_for_claudes_toolbox

mcp_server_for_claudes_toolbox

作者：Claude 3.7 Sonnet、Kyle Rose

版本：0.2.0

一个服务器应用，通过模型上下文协议（MCP）提供 Claude 的 Toolbox 实用程序，让 Claude 等 AI 助手能够通过不同的接口（Claude Code、Claude Desktop、Copilot 等）使用这些程序。

功能

• 注册和调用任意函数。只需将函数添加到 tools/functions 文件夹，并以函数名命名文件，即可使用。
• 提供一组用于执行各种任务的独立命令行界面（CLI）工具。目前包括：
  • test_generator：根据 JSON 规范创建 unittest 测试文件。
  • documentation_generator：根据 Python 源代码生成 Markdown 文档。
  • lint_a_python_codebase：修复 Python 文件中的常见代码检查问题，例如空行、行尾空格和换行符。
  • run_tests_and_save_their_results：为 Python 项目运行单元测试、类型检查和代码检查，并将结果保存为 JSON 和 Markdown 文件。
  • codebase_search：使用模式匹配搜索代码。
• 每个 CLI 工具本身都是一个完整程序，并可配置使用自己的虚拟环境。调用工具时，服务器会自动启用相应的虚拟环境。
• 可在 configs.yaml 文件中自定义服务器设置，轻松更改详细程度、日志级别、主机、端口和重新加载选项等设置。
• 支持跨平台工具，包括 WSL2、Linux/MacOS 和 Windows。这样一来，服务器可以在 Windows 上注册并运行为 Posix 环境编写的工具，反之亦然。只需将相应的配置代码添加到适用于你平台的 MCP 配置文件中。

配置

可以通过 configs.yaml 文件配置服务器：

verbose: True
log_level: 10
host: '0.0.0.0'
port: 8000
reload: True
load_from_paths_csv: True

要求

• WSL2、Linux。即将支持 Windows。
• Python 3.12+
• mcp # 用于 MCP 服务
• aiofile # 用于异步文件操作
• anthropic # 用于访问 Anthropic 的大模型 API
• coverage # 用于测试覆盖率
• duckdb # 用于跨平台数据库操作
• flask # 用于 Web 框架
• flake8 # 用于代码检查
• httpx # 用于异步 HTTP 请求
• jinja2 # 用于模板
• mcp # 用于 Claude 工具服务 API
• multiformats # 用于创建 CID
• mypy # 用于类型检查
• numpy # 用于数值运算
• openai # 用于访问 OpenAI 的大模型 API
• psutil # 用于系统和进程实用程序
• pydantic # 用于数据验证和设置管理
• pytest # 用于测试
• pyyaml # 用于解析 YAML
• tqdm # 用于进度条

安装

1. 克隆此仓库：

git clone https://github.com/the-ride-never-ends/claudes_toolbox

2. 运行安装脚本：

适用于 Linux/MacOS：

cd claudes_toolbox
bash ./install_server.sh

适用于 Windows：

cd claudes_toolbox
cmd .\install_server.bat

3. 将相应的配置代码复制并粘贴到相关的 MCP 配置文件中。 对于 Windows 上的 Claude Desktop，该文件通常位于 C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json。

服务托管在 WSL 上：

run_wsl.config

"claudes-toolbox": {
    "command": "wsl",
    "args": [
    "bash",
    "-c",
    "source ~/.bashrc && ~/claudes_toolbox/mcp_server_for_claudes_toolbox/start_claudes_toolbox_server.sh --called-with-wsl"
    ]
}

服务托管在 Linux/MacOS 上：

run_linux.config

"claudes-toolbox": {
  "command": "bash",
  "args": [
    "-c",
    "source ~/.bashrc || source ~/.bash_profile || source ~/.zshrc; ~/claudes_toolbox/start_server.sh"
  ]
}

服务托管在 Windows 上：

"claudes-toolbox": {
    "command": "cmd.exe",
    "args": [
        "/c",
        "C:\\path\\to\\start_server.bat"
    ]
}

4. 将其他仓库 Git 克隆到 claude_toolbox/tools/cli 目录中：

cd claudes_toolbox/tools
git clone https://github.com/the-ride-never-ends/documentation_generator
git clone https://github.com/the-ride-never-ends/test_generator
git clone https://github.com/the-ride-never-ends/run_tests_and_save_their_results
git clone https://github.com/the-ride-never-ends/lint_a_python_codebase
git clone https://github.com/the-ride-never-ends/codebase_search

调用工具时，服务器会自动启用相应的虚拟环境。

用法

Copilot、Claude Code 和 Claude Desktop 等集成应用可以使用 MCP 协议调用服务器。执行指定命令后，服务器会自动启动。

服务器的工作方式：

• 通过子进程调用在命令行中运行工具
• 使用可启用虚拟环境的包装函数
• 通过 MCP 协议提供带有相应参数的各个工具

目录结构

mcp_server_for_claudes_toolbox/
├── docs/               # Documentation files
├── tests/              # Test files and test cases
├── utils/              # Utility scripts
├── data/               # Data files used by the program (if any)
├── app.py              # MCP server application
├── configs.py          # Configurations singleton for the program
├── logger.py           # Logger singleton for the program
├── TODO.md             # Todo list 
├── CHANGELOG.md        # Changelog list
├── claude.md           # Instructions to Claude in Claude Code API
├── requirements.txt    # 3rd-party library requirements
├── install.sh          # Set-up venv and install requirements
├── start.sh            # Script to start the server
└── README.md           # This file

许可证

MIT