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凭据
- 通过
openaiPython客户端 - 返回纯文本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这将：
- 检查先决条件(
uv,jq，macOS钥匙链） - 安装
mcp_server.py到~/.local/share/ai-tools-mcp/ - 提示输入API令牌并将其存储在macOS密钥链中
- 在中注册MCP服务器
~/.claude/.mcp.json - 运行飞行前检查以验证依赖关系和配置
可以安全地多次运行——更新现有配置而不会造成破坏。
需求
系统
- macOS
uv已安装并打开PATHjq已安装（仅适用于安装程序）
钥匙链条目
服务器需要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查找而不是环境文件存储
许可证
尚未添加许可证文件。如果你打算接受贡献或希望重用清晰，请明确添加一个。