使用说明
项目简介
MCP Tools 是一个基于 Model Context Protocol (MCP) 构建的工具集,它充当 MCP 服务器,旨在弥合 AI 助手(如 Claude)与外部数字生态系统之间的差距。通过提供标准化的接口,MCP Tools 使 AI 助手能够安全有效地与各种外部系统、数据源和实用程序进行交互,类似于 USB-C 为各种设备提供标准化连接的方式。
主要功能点
- Web Scraping Tool (scrape_url): 从网站提取并处理内容,用于获取网页文本信息。
- Brave Search Tool (brave_search): 使用 Brave Search API 检索互联网搜索结果,用于信息查询和研究。
- Quick Bash Tool (quick_bash): 执行简单的 shell 命令,用于快速系统操作和脚本执行。
- Aider Tool (aider): AI 辅助编程工具,支持 Anthropic (Claude) 和 OpenAI (GPT) 多种模型,用于代码修改和生成。
- Long Running Task Tool (long_running_tool): 管理长时间运行的后台任务,适用于需要数分钟甚至数小时完成的操作。
- Regex Replace Tool (regex_replace): 使用正则表达式进行多行文本替换,安全修改文件内容。
- Git Integration Tool (git): Git 版本控制工具,用于代码变更管理。
- Oracle Database Tool (oracle_select): 执行 Oracle 数据库 SELECT 查询,用于数据检索。
- Gmail Integration Tool (gmail_tool): Gmail 集成工具,支持 OAuth 2.0 授权、邮件发送、搜索和管理。
- Email Validation Tool (never_bounce_tool): 使用 NeverBounce API 验证电子邮件地址的有效性。
- Google Search Tool (google_search): 使用 Google Custom Search API 进行网页搜索。
- Mermaid Chart Tool (mermaid_chart): 根据代码文件生成 Mermaid 图表,用于可视化代码结构和关系。
安装步骤
- 安装 Rust 环境: 确保已安装最新稳定版本的 Rust 和 Cargo。
- 克隆仓库:
git clone https://github.com/robert-at-pretension-io/mcp cd mcp - 构建项目:
cd mcp_tools && cargo build --release - 获取可执行文件路径: 构建成功后,在 'mcp/mcp_tools/target/release/' 目录下可以找到可执行文件 'mcp_tools' (或 'mcp_tools.exe' on Windows)。
- 设置环境变量: 根据需要启用的工具配置相应的 API 密钥等环境变量,例如 'SCRAPINGBEE_API_KEY', 'BRAVE_API_KEY', 'ANTHROPIC_API_KEY', 'OPENAI_API_KEY' 等。具体环境变量要求请参考仓库 README 文档。
服务器配置
MCP 服务器需要通过 'claude_desktop_config.json' 文件配置,以便 Claude Desktop 客户端能够连接。配置文件位置:
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
配置示例 (JSON 格式):
{ "mcpServers": { "tools": { "command": "[可执行文件路径]", // 将此路径替换为步骤4中获取的 'mcp_tools' 可执行文件的完整路径 "args": [], // 启动参数,本例中为空 "env": { "SCRAPINGBEE_API_KEY": "[您的 ScrapingBee API 密钥]", // 如果启用 Web Scraping Tool,请填写您的 ScrapingBee API 密钥 "BRAVE_API_KEY": "[您的 Brave Search API 密钥]", // 如果启用 Brave Search Tool,请填写您的 Brave Search API 密钥 "ANTHROPIC_API_KEY": "[您的 Anthropic API 密钥]", // 如果启用 Aider Tool (Anthropic),请填写您的 Anthropic API 密钥 "OPENAI_API_KEY": "[您的 OpenAI API 密钥]" // 如果启用 Aider Tool (OpenAI),请填写您的 OpenAI API 密钥 } } } }
基本使用方法
- 确保 MCP 服务器已成功构建并配置。
- 启动 MCP 服务器:在终端中运行 'mcp_tools' 可执行文件。
- 配置 Claude Desktop 客户端:根据上述 “服务器配置” 部分,配置 'claude_desktop_config.json' 文件,指定 MCP 服务器的启动命令和必要的环境变量。
- 在 Claude Desktop 中,即可通过自然语言指令调用 MCP 服务器提供的各种工具,例如,可以使用 '@tools' 提及工具并传递参数。
请注意,具体工具的使用方法和参数,请参考仓库中各个工具的详细说明文档和 'input_schema' 定义。
信息
分类
开发者工具