AI导哈

GraphQL服务器集成工具

该工具用于在Claude Desktop中集成和运行Apollo GraphQL服务器，支持创建和管理GraphQL API，适用于开发者在本地环境中测试和调试GraphQL查询。

  • by amandipd
  • 本地部署
  • 更新于
在 GitHub 查看 amandipd/mcp-server-integration-within-claude-desktop-instructions

使用说明

Claude桌面指令中的MCP服务器集成

创建虚拟阿波罗图并获取凭据

  1. 在您的首选位置为Apollo Graph项目创建一个空目录
  2. 打开终端并导航到此目录的根目录
  3. 运行漫游车初始化以初始化新的阿波罗图
  4. 按照终端中出现的提示设置图形
  5. 成功创建后，将显示您的APOLLO_GRAPH_REF和APOLLO_KEY凭据-复制并安全保存这些值
  6. 在项目目录中，找到supergraph.yaml文件，并将其全部内容替换为：
    federation_version: =2.10.0
subgraphs:
  listings:
    routing_url: https://rt-airlock-subgraphs-listings.herokuapp.com/
    schema:
      subgraph_url: https://rt-airlock-subgraphs-listings.herokuapp.com/
    • 此配置使用示例API，这些API提供阿波罗MCP教程中的宇宙飞船数据

克隆和运行Apollo运行时容器

  1. 从以下位置克隆Apollo Runtime存储库：https://github.com/apollographql/apollo-runtime?tab=readme-ov文件
  2. 导航到克隆存储库的根目录，并验证Docker Desktop是否正在运行
  3. 执行以下命令，用实际凭据替换INSERT_HERE：
docker run \
--env APOLLO_GRAPH_REF="INSERT_HERE" \
--env APOLLO_KEY="INSERT_HERE" \
--env MCP_ENABLE=1 \
--env MCP_UPLINK=1 \
--rm \
-p 4000:4000 \
-p 5050:5000 \
ghcr.io/apollographql/apollo-runtime:latest
  1. 成功执行后：
    • 访问localhost:4000访问GraphQL API端点
    • 访问studio.apollographql.com/sandbox？端点=http://localhost:4000访问Apollo Studio资源管理器以创建和测试查询

运行MCP服务器并连接到Claude桌面

  1. 在Apollo图形项目中，创建一个名为operations的新文件夹
  2. 在操作文件夹中，创建一个名为listings.graphql的文件，并添加以下示例查询：
  query ExampleQuery {
  products {
    name
    description
    id
  }
}
  1. 从项目根目录运行以下命令启动MCP服务器：
rover dev --supergraph-config ./supergraph.yaml `
  --mcp `
  --mcp-operations ./operations/listings.graphql
  1. 启动Claude Desktop并从应用程序菜单访问设置
  2. 导航到“开发人员”部分，然后单击“编辑配置”
  3. 使用以下配置更新claude_desktop_config文件：
{
  "mcpServers": {
    "airlock": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://127.0.0.1:5000/mcp",
        "--transport",
        "http-first"
      ]
    }
  }
}
  1. 重新启动Claude Desktop以保存这些更改
  2. 返回Claude Desktop并启用界面中显示的新工具。您现在可以要求Claude执行API查询，并从Apollo图中接收结果

相关 MCP