AI Tools MCP

ai工具mcp

ai-tools-mcp 是一个小型MCP服务器，在稳定的本地MCP表面后面暴露托管的AI提供商。

此存储库有意缩小范围：

• 它适用于托管的API支持MCP工具。
• 它不是本地模型仓库。
• 它目前公开了一个工具：

- deep_research

稳定的公共表面

除非有意更改，否则以下标识符将保持稳定：

• MCP服务器密钥： ai-tools-mcp
• 工具名称： deep_research

提供商映射

deep_research

• 提供者：困惑
• 型号： sonar-pro
• 目的：通过多源综合、交叉引用和引用进行深入研究
• 补充了Claude内置的WebSearch（使用WebSearch进行快速查找，使用deep_research进行彻底调查）

运作原理

服务器是一个单一的Python脚本(mcp_server.py)PEP 723内联依赖元数据。 uv run 自动解析和缓存依赖关系——无virtualenv，无 requirements.txt，无构建步骤。

它

• 启动名为的MCP服务器 ai-tools-mcp
• 从macOS钥匙串读取API凭据
• 通过 openai Python客户端
• 返回纯文本MCP响应

仓库中没有本地模型权重，没有后台服务，也没有嵌入的秘密。

仓库的规划

• mcp_server.py：具有内联依赖元数据的自包含MCP服务器
• install.sh：macOS安装程序（钥匙链设置、克劳德代码注册、飞行前检查）
• scripts/launch_ai_tools_mcp.sh：传统启动器（基于virtualenv，适用于Claude Desktop）
• scripts/configure_claude_ai_tools_mcp.sh：Claude桌面注册助手
• scripts/uv_sync_projects.sh：用于同步Python项目的独立本地助手 uv

安装

建议通过随附的安装程序进行安装：

./install.sh

这将：

1. 检查先决条件(uv, jq，macOS钥匙链）
2. 安装 mcp_server.py 到 ~/.local/share/ai-tools-mcp/
3. 提示输入API令牌并将其存储在macOS密钥链中
4. 在中注册MCP服务器 ~/.claude/.mcp.json
5. 运行飞行前检查以验证依赖关系和配置

可以安全地多次运行——更新现有配置而不会造成破坏。

需求

系统

• macOS
• uv 已安装并打开 PATH
• jq 已安装（仅适用于安装程序）

钥匙链条目

服务器需要macOS密钥链中的API密钥：

• 服务 api_tokens账户 perplexity

安装程序会自动处理此问题。对于手动设置：

security add-generic-password -s 'api_tokens' -a 'perplexity' -w 'YOUR_PERPLEXITY_API_KEY'

跑步

推荐的跑步方式是通过 uv run，其读取PEP 723内联元数据并自动管理依赖关系：

uv run mcp_server.py

无需创建virtualenv或安装依赖项-- uv 从全局缓存中处理它。

预检

在不启动服务器的情况下验证依赖关系是否已解决以及Keychain条目是否存在：

uv run mcp_server.py --check

克劳德代码注册

安装程序会处理这个问题。对于手动设置，请添加 ~/.claude/.mcp.json:

{
  "mcpServers": {
    "ai-tools-mcp": {
      "command": "uv",
      "args": ["run", "/path/to/ai-tools-mcp/mcp_server.py"]
    }
  }
}

克劳德桌面注册

对于Claude Desktop（使用传统的virtualenv启动器）：

./scripts/configure_claude_ai_tools_mcp.sh

工具输入

deep_research

输入架构：

• query：必填字符串
• max_tokens：可选整数，默认值 2048

输出行为：

• 返回包含研究结果的格式化文本块
• 依赖于困惑反应内容来包括引用

开发说明

• 此回购有意设计得较小且用途单一。
• 保持公共MCP表面稳定。
• 避免在此处添加无关的自动化或本地模型功能。
• 如果功能超出托管的MCP工具，它可能会存在于不同的仓库中。

秘密卫生

此回购旨在安全地公开发布。当前的设计通过使用macOS Keychain将秘密置于源代码控制之外。

在此仓库中工作的规则：

• 永远不要提交原始API密钥、会话令牌或承载令牌
• 永不承诺 .env 文件
• 从不提交证书或私钥文件
• 将本地调试转储从Git中删除
• 对于此项目，更喜欢Keychain查找而不是环境文件存储

许可证

尚未添加许可证文件。如果你打算接受贡献或希望重用清晰，请明确添加一个。