使用说明

项目简介

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 图表,用于可视化代码结构和关系。

安装步骤

  1. 安装 Rust 环境: 确保已安装最新稳定版本的 Rust 和 Cargo。
  2. 克隆仓库:
    git clone https://github.com/robert-at-pretension-io/mcp
    cd mcp
  3. 构建项目:
    cd mcp_tools && cargo build --release
  4. 获取可执行文件路径: 构建成功后,在 'mcp/mcp_tools/target/release/' 目录下可以找到可执行文件 'mcp_tools' (或 'mcp_tools.exe' on Windows)。
  5. 设置环境变量: 根据需要启用的工具配置相应的 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 密钥
      }
    }
  }
}

基本使用方法

  1. 确保 MCP 服务器已成功构建并配置。
  2. 启动 MCP 服务器:在终端中运行 'mcp_tools' 可执行文件。
  3. 配置 Claude Desktop 客户端:根据上述 “服务器配置” 部分,配置 'claude_desktop_config.json' 文件,指定 MCP 服务器的启动命令和必要的环境变量。
  4. 在 Claude Desktop 中,即可通过自然语言指令调用 MCP 服务器提供的各种工具,例如,可以使用 '@tools' 提及工具并传递参数。

请注意,具体工具的使用方法和参数,请参考仓库中各个工具的详细说明文档和 'input_schema' 定义。

信息

分类

开发者工具