跳转到主内容

Claude 桌面版集成

本指南专门介绍如何将您本地运行的 GPT Researcher MCP 服务器与 Claude 的 Mac 桌面应用程序集成,从而在 Claude 界面内提供无缝的研究体验。

在此处查看官方 Anthropic MCP 文档:链接

先决条件

在与 Claude 桌面客户端集成之前,您需要:

  1. GPT Researcher MCP 服务器已在本地安装并运行
  2. 已安装 Claude for Mac 桌面应用程序
  3. 拥有您 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 桌面版

  1. 找到 Claude 的配置文件:

    • 打开“访达”并按 Shift + Command + G 打开“前往文件夹”对话框。
    • 输入 ~/Library/Application Support/Claude/ 并点击“前往”。
    • 在此目录中找到 claude_desktop_config.json 文件。如果该文件不存在,请创建一个同名的新文件。
    • 或者,您也可以打开 Claude 应用 -> 设置 -> 开发者 -> 更新配置。
  2. 编辑配置文件:

    • 用文本编辑器打开 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

集成后,您可以通过以下方式使用研究功能:

  1. 点击消息输入区域的锤子图标(🔨)。
  2. 选择 "conduct_research" 工具。
  3. 输入您的研究查询和其他参数。
  4. 提交您的查询。

您也可以直接提示 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.

故障排除

如果您在集成过程中遇到问题:

  1. 服务器连接问题:

    • 确保 MCP 服务器正在运行并在预期的端口上监听。
    • 检查可能阻止连接的防火墙设置。
    • 验证配置文件中的路径是否正确。
  2. 工具可用性问题:

    • 如果工具没有显示,请重启 MCP 服务器和 Claude。
    • 检查服务器日志以查找任何错误消息。
    • 确保您的 API 密钥在 .env 文件中已正确配置。
  3. 权限问题:

    • 确保 Claude 有权限执行服务器脚本。
    • 检查 server.py 文件的文件权限。
  4. 配置文件问题:

    • 验证配置文件中的 JSON 语法是否正确。
    • 确保配置目录存在且可访问。

后续步骤