使用说明
项目简介
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密钥和调整服务器设置。
安装步骤
-
安装 mcptoolkit: 推荐使用 pip 安装,执行以下命令:
pip install mcptoolkit或者使用 Docker 镜像,无需安装 Python 环境。
-
启动 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()
- Docker: 推荐使用 Docker 运行,命令如下:
-
配置 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" } }
基本使用方法
- 启动 MCP 服务器 并确保 Claude 桌面应用已配置并连接到服务器。
- 使用 Claude 客户端,可以通过自然语言指令或 'client.call_tool()' 方法调用 MCP Tool Kit 提供的工具。
- 参考示例 Prompt,例如使用 SEO 分析工具:
更多工具的使用方法和 Prompt 示例请参考仓库的 README 文档。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"})
注意: 部分工具(如 Brave Search, NewsAPI, Shopify 等)需要配置相应的 API 密钥,请查阅 README 文档获取详细信息。
信息
分类
开发者工具