使用说明

项目简介

MCP Tool Kit 是一个为 Claude AI 助手设计的模块化服务器,它基于 Model Context Protocol (MCP) 构建,旨在通过集成各种工具来增强 Claude 的能力。该工具包允许 Claude 与外部系统和服务进行交互,例如文件系统、网络搜索、浏览器自动化、以及各种API,从而实现更丰富和复杂的功能。

主要功能点

  • 文件系统操作: 允许 Claude 读取、写入和编辑服务器上的文件,方便数据处理和内容管理。
  • 网络搜索: 集成 Brave Search API,使 Claude 具备强大的网络搜索和信息检索能力。
  • 浏览器自动化: 通过 Browserbase 和 Playwright 实现完整的浏览器控制,支持网页浏览、信息抓取和用户交互模拟。
  • 多API集成: 预置了 World Bank API、News API、Yahoo Finance、FRED 等多个数据源的接口,方便 Claude 获取经济、金融和新闻资讯。
  • 扩展性: 模块化设计,用户可以轻松添加自定义工具,扩展 Claude 的应用场景。
  • 配置UI: 提供基于 Web 的配置界面,方便用户管理工具启用、配置API密钥和调整服务器设置。

安装步骤

  1. 安装 mcptoolkit: 推荐使用 pip 安装,执行以下命令:

    pip install mcptoolkit

    或者使用 Docker 镜像,无需安装 Python 环境。

  2. 启动 MCP 服务器: 根据您的选择,可以通过以下几种方式启动服务器:

    • Docker: 推荐使用 Docker 运行,命令如下:
      docker run -p 8000:8000 -v ~/documents:/app/documents getfounded/mcp-tool-kit:latest
    • docker-compose: 如果您安装了 Docker Compose,可以使用 'docker-compose up' 命令。
    • 命令行: 如果通过 pip 安装,可以直接运行 'mcptoolkit-server' 或 'mcptoolkit-launcher' 命令。
    • Python 模块: 在 Python 环境中,可以使用模块方式启动:
      from mcptoolkit import mcp_unified_server
      server = mcp_unified_server.create_server()
      server.start()
  3. 配置 Claude 桌面应用:

    • 打开 Claude 桌面应用。
    • 进入 "File" -> "Settings" -> "Developer" -> "Edit config"。
    • 添加或修改 'claude_desktop_configuration.json' 配置文件,确保配置指向您的 MCP 服务器地址(默认为 'http://localhost:8000')。

服务器配置

MCP 服务器需要配置后才能与 MCP 客户端(如 Claude 桌面应用)连接。以下是一个典型的 'claude_desktop_configuration.json' 配置文件示例,您需要将其添加到 Claude 桌面应用的配置中。

{
  "tools": [
    {
      "name": "MCP Toolkit",  // MCP 工具服务器的名称,Claude 客户端中会显示此名称
      "url": "http://localhost:8000" // MCP 工具服务器的URL,确保与服务器实际运行地址一致
    }
  ],
  "settings": {
    "allowed_directories": ["~/Documents", "~/Downloads"], // 允许文件系统工具访问的目录,请根据实际需要配置
    "default_tools": ["MCP Toolkit"] // 默认启用的工具服务器列表,这里设置为 "MCP Toolkit"
  }
}

基本使用方法

  1. 启动 MCP 服务器 并确保 Claude 桌面应用已配置并连接到服务器。
  2. 使用 Claude 客户端,可以通过自然语言指令或 'client.call_tool()' 方法调用 MCP Tool Kit 提供的工具。
  3. 参考示例 Prompt,例如使用 SEO 分析工具:
    Claude, I've added an SEO analysis tool to your toolkit. Can you please analyze the SEO for my website at https://example.com and provide recommendations for improvement?
    
    The tool can be accessed using:
    client.call_tool("analyze_seo", {"url": "https://example.com"})
    更多工具的使用方法和 Prompt 示例请参考仓库的 README 文档。

注意: 部分工具(如 Brave Search, NewsAPI, Shopify 等)需要配置相应的 API 密钥,请查阅 README 文档获取详细信息。

信息

分类

开发者工具