Claude 桌面版集成
本指南专门介绍如何将您本地运行的 GPT Researcher MCP 服务器与 Claude 的 Mac 桌面应用程序集成,从而在 Claude 界面内提供无缝的研究体验。
在此处查看官方 Anthropic MCP 文档:链接
先决条件
在与 Claude 桌面客户端集成之前,您需要:
- GPT Researcher MCP 服务器已在本地安装并运行
- 已安装 Claude for Mac 桌面应用程序
- 拥有您 Mac 的管理权限,以便修改配置文件
设置 Claude 桌面版与 MCP 的集成
要将本地运行的 MCP 服务器与 Claude for Mac 集成,请按照以下步骤操作:
1. 安装并运行 GPT Researcher MCP 服务器
确保您已安装并运行 GPT Researcher MCP 服务器。
# Clone the repository (if you haven't already)
git clone https://github.com/assafelovic/gptr-mcp.git
# Install dependencies
pip install -r requirements.txt
# Set up your environment variables
cp .env.example .env
# Edit the .env file with your API keys
# Run the server
python server.py
通过检查控制台输出来验证服务器是否正常运行。默认情况下,服务器应在端口 8000 上监听。
2. 配置 Claude 桌面版
-
找到 Claude 的配置文件:
- 打开“访达”并按
Shift + Command + G打开“前往文件夹”对话框。 - 输入
~/Library/Application Support/Claude/并点击“前往”。 - 在此目录中找到
claude_desktop_config.json文件。如果该文件不存在,请创建一个同名的新文件。 - 或者,您也可以打开 Claude 应用 -> 设置 -> 开发者 -> 更新配置。
- 打开“访达”并按
-
编辑配置文件:
- 用文本编辑器打开
claude_desktop_config.json。 - 添加或更新
mcpServers部分,以包含您的本地 GPT Researcher MCP 服务器。
- 用文本编辑器打开
{
"mcpServers": {
"gpt-researcher": {
"command": "/path/to/python",
"args": ["/path/to/gptr-mcp/server.py"]
}
}
}
将 /path/to/gptr-mcp/server.py 替换为您的 server.py 文件的绝对路径。
另外,如果您更喜欢手动启动服务器,只让 Claude 连接到它:
{
"mcpServers": {},
"externalMCPServers": {
"gpt-researcher": "https://:8000/mcp"
}
}
3. 重启 Claude 桌面版
关闭并重新打开 Claude 应用程序以应用新配置。
4. 验证集成
重启后:
- 在 Claude 输入框的右下角寻找一个锤子图标(🔨)。
- 点击此图标应显示由您的 MCP 服务器提供的 GPT Researcher 工具。
- 如果您没有看到锤子图标,请检查 Claude 应用程序日志以查找任何错误。
在 Claude 桌面版中使用 GPT Researcher
集成后,您可以通过以下方式使用研究功能:
- 点击消息输入区域的锤子图标(🔨)。
- 选择 "conduct_research" 工具。
- 输入您的研究查询和其他参数。
- 提交您的查询。
您也可以直接提示 Claude 使用这些工具。
I need to research the latest advancements in quantum computing. Please use the conduct_research tool to gather information, then create a comprehensive report.
故障排除
如果您在集成过程中遇到问题:
-
服务器连接问题:
- 确保 MCP 服务器正在运行并在预期的端口上监听。
- 检查可能阻止连接的防火墙设置。
- 验证配置文件中的路径是否正确。
-
工具可用性问题:
- 如果工具没有显示,请重启 MCP 服务器和 Claude。
- 检查服务器日志以查找任何错误消息。
- 确保您的 API 密钥在 .env 文件中已正确配置。
-
权限问题:
- 确保 Claude 有权限执行服务器脚本。
- 检查 server.py 文件的文件权限。
-
配置文件问题:
- 验证配置文件中的 JSON 语法是否正确。
- 确保配置目录存在且可访问。