MCP 工具包

一个用于构建高精度垂直AI代理的模块化服务器实现。旨在用于构建高精度垂直AI代理，但也可以部署以获得通用工具功能。

使用的代码比单独使用Python MCP SDK少>=50%。

该方法的优点

• 减少Claude的认知负担：Claude不需要考虑工具调用的顺序
• 封装领域知识：代理可以包含关于如何在特定垂直领域中良好执行任务的领域特定逻辑
• 简化错误处理：代理可以在内部处理错误和重试，无需Claude参与
• 支持复杂工作流：通过单个工具调用难以协调的多步骤过程
• 保持对话流畅：用户不会暴露于底层系统的复杂性

示例场景

以下是一个具体的Claude调用垂直代理的例子：

User: "I need a comprehensive analysis of the electric vehicle market for a presentation tomorrow."

Claude: [recognizes this requires multiple tools and domain expertise]

Claude: "I'll help you with that comprehensive EV market analysis. I'll need to gather the latest market data, news, and trends. This will take a moment..."

[Behind the scenes, Claude calls a MarketAnalysisAgent]

Claude -> MarketAnalysisAgent.analyze_market(
    sector="electric vehicles",
    include_news=True,
    include_market_data=True,
    create_presentation=True
)

[The agent orchestrates multiple tool calls using your toolkit]
- news_search for recent EV news
- brave_web_search for market data
- sequential_thinking for analysis
- write_file to save the report
- ppt_create_presentation to generate slides

[Agent returns results to Claude]

Claude: "I've analyzed the electric vehicle market for you. Here are the key findings:
1. Tesla continues to lead with 65% market share in North America
2. BYD has overtaken VW in global sales volume
3. Battery technology breakthroughs are accelerating adoption

I've also created a presentation with detailed charts and data. You can find it saved as 'EV_Market_Analysis.pptx' in your working directory."

概述

MCP统一服务器为Claude提供了一个与各种外部系统和工具交互的统一接口，包括：

• 文件系统操作：读取、写入和操作文件
• 时间工具：获取不同时区的当前时间，进行时区转换
• 序列思考：一种动态和反思性的问题解决工具
• Brave搜索：网络和本地搜索能力
• 浏览器自动化：通过Playwright完全控制浏览器
• 世界银行API：访问经济和发展数据
• 新闻API：访问全球新闻来源和文章
• PowerPoint：创建和操作PowerPoint演示文稿
• Excel：创建和操作Excel电子表格
• Yahoo Finance：股票市场和金融数据
• FRED：联邦储备经济数据
• 代理能力：创建并部署执行复杂任务的自主代理
• 以及更多专门工具

共有123种工具可用

快速入门指南：使用默认工具部署您的第一个MCP服务器

注意：确保您已下载git (https://git-scm.com/downloads) 和 Docker (https://www.docker.com/products/docker-desktop/) 并且它们正在运行。您还必须确保git可执行文件已添加到路径中（本README末尾有说明）。

Docker 部署（推荐且最稳定）

1. 克隆仓库：

clone https://github.com/getfounded/mcp-tool-kit.git
cd mcp-tool-kit

1. 然后您可以使用Docker的两种方式之一： 选项1 - 使用docker-compose：

docker-compose up

选项2 - 直接使用Docker命令：

docker run -p 8000:8000 -v ~/documents:/app/documents getfounded/mcp-tool-kit:latest

该仓库包含一个示例Claude桌面配置文件 (claude_desktop_config.json)，您可以使用它：

{
  "mcpServers": {
    "unified": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "mcp-tool-kit-mcp-server",
        "python",
        "-u",
        "mcp_unified_server.py"
      ],
      "useStdio": true
    }
  }
}

故障排查 Docker

如果您在运行 Docker 时遇到错误，很可能是因为 Claude 桌面配置文件中的镜像名称不正确。一个常见的解决方法是使用以下 JSON 进行配置：

{
  "mcpServers": {
    "unified": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "mcp-tool-kit-mcp-server-1",
        "python",
        "-u",
        "mcp_unified_server.py"
      ],
      "useStdio": true
    }
  }
}

通过 pip 安装

# Simple installation
pip install mcptoolkit

# Launch the server with default configuration
mcptoolkit-server

本地服务器基本配置：

{
  "tools": [
    {
      "name": "MCP Toolkit",
      "url": "http://localhost:8000"
    }
  ],
  "settings": {
    "allowed_directories": ["~/Documents", "~/Downloads"],
    "default_tools": ["MCP Toolkit"]
  }
}

配置 Claude Desktop 以访问您的服务器

1. 打开 Claude Desktop 应用程序
2. 转到 文件 > 设置 > 开发者 > 编辑配置
3. 添加 'claude_desktop_configuration.json' 文件
4. 保存配置
5. 重启 MCP 服务器并集成您的新工具
6. 重启并打开 Claude Desktop 应用程序（对于 Windows 用户，您必须使用任务管理器结束所有 Claude 实例的任务）

您可以在 Claude 桌面应用程序中导入此配置，或者将其作为参考来创建自己的配置。

现在，您可以立即访问强大的功能，包括文件操作、网络搜索、时间工具等——无需任何 API 密钥或复杂的设置。

设置环境变量

克隆仓库后，您有两种方法可以配置环境变量：

选项 1：交互式设置脚本

运行设置脚本，该脚本将引导您完成环境变量的设置：

python setup_env.py

此脚本将在仓库中创建一个包含您的配置的 .env 文件。

选项 2：手动配置

或者，您可以在仓库根目录下手动创建一个 .env 文件，并包含以下变量：

# API Keys for external services
BRAVE_API_KEY=your_brave_api_key
NEWS_API_KEY=your_news_api_key
FRED_API_KEY=your_fred_api_key

# Application configuration
STREAMLIT_APPS_DIR=/path/to/streamlit/apps
MCP_FILESYSTEM_DIRS=/path/to/allowed/dir1,/path/to/allowed/dir2
MCP_LOG_LEVEL=info

示例 Claude 提示

设置完成后，您可以使用如下提示让 Claude 使用这些工具：

• "搜索最新的 AI 研究论文并总结其发现。"
• "创建一个关于气候变化的 PowerPoint 演示文稿，共三页。"
• "使用 weather_checker 代理告诉我东京当前的天气状况。"
• "你能使用 quick_lookup 代理研究量子计算的进步吗？"
• "下载我的 QuickBooks 发票数据并分析我们上个季度的收入。"
• "在我的 Shopify 商店中使用这些详细信息和定价设置一个产品。"
• "使用 Yahoo Finance 获取特斯拉的当前股价和历史数据。"
• "使用 FRED 经济数据分析过去五年的通货膨胀趋势。"
• "使用浏览器自动化填写 [网站 URL] 的表单。"
• "读取我下载文件夹中名为 'project_notes.txt' 的文本文件。"
• "获取有关技术的最新新闻头条。"

可用工具

文件系统工具

- `read_file`: 读取文件内容
- `read_multiple_files`: 同时读取多个文件
- `write_file`: 创建或覆盖文件
- `edit_file`: 对文件进行基于行的编辑
- `create_directory`: 创建新目录
- `list_directory`: 获取目录内容
- `directory_tree`: 获取递归树视图
- `move_file`: 移动或重命名文件/目录
- `search_files`: 搜索匹配模式的文件
- `get_file_info`: 获取文件元数据
- `list_allowed_directories`: 列出允许访问的目录

- **Browser_Automation:**
  - `playwright_launch_browser`: 启动新的浏览器实例
  - `playwright_navigate`: 导航到指定 URL
  - `playwright_screenshot`: 截图
  - `playwright_click`: 点击元素
  - `playwright_fill`: 填充输入字段
  - `playwright_evaluate`: 执行 JavaScript
  - `playwright_get_content`: 获取页面的 HTML 内容

### Agent Tools
- `run_agent`: 使用参数执行已注册的代理
- `list_agents`: 列出所有可用代理及其元数据

### Financial Data Tools
- **Y…