项目简介

Apollo Runtime Container集成了Apollo Router和实验性的MCP服务器。此MCP服务器旨在标准化地向大型语言模型（LLM）客户端提供上下文信息和功能，通过JSON-RPC协议允许LLM访问数据资源、调用外部功能以及使用预定义的Prompt模板。它能够托管和管理GraphQL API模式和操作，将其作为LLM可用的工具和资源。

主要功能点

上下文服务： 向LLM提供结构化的数据和操作能力。
API托管： 能够加载和管理GraphQL API模式，将其作为资源暴露给LLM。
工具集成： 支持定义和执行操作（operations），允许LLM通过预定义的接口调用后端功能。
会话管理： 支持LLM客户端的会话连接和交互。
容器化部署： 提供Docker镜像，方便快速部署和运行。

安装步骤

本MCP服务器以Docker容器形式提供，无需传统安装步骤，只需通过Docker命令拉取并运行镜像：

docker pull ghcr.io/apollographql/apollo-runtime:latest
# 或者 docker pull apollograph/apollo-runtime:latest

服务器配置

MCP客户端需要配置与此服务器连接的详细信息。以下是您可能需要提供的配置示例及说明：

{
  "server_name": "Apollo MCP Server",
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-p", "5050:5000",
    "--env", "MCP_ENABLE=1",
    "--env", "APOLLO_GRAPH_REF=\"your graph here\"",
    "--env", "APOLLO_KEY=\"your key here\"",
    "ghcr.io/apollographql/apollo-runtime:latest"
  ],
  "notes": "请将'APOLLO_GRAPH_REF'和'APOLLO_KEY'替换为您的实际Apollo GraphOS图引用和API密钥。服务器将在本地的5050端口启动，并且MCP服务将在'/mcp'路径下提供。"
}

参数注释:

'server_name': 任意描述性名称，用于标识此MCP服务器实例。
'command': 启动MCP服务器的命令，这里是'docker'。
'args': 传递给'command'的参数列表，用于配置Docker容器的运行。
- '--rm': 容器退出时自动移除。
- '-p 5050:5000': 将容器内部的5000端口映射到主机的5050端口，MCP服务器在此端口监听。
- '--env MCP_ENABLE=1': 启用MCP服务器功能（必需）。
- '--env APOLLO_GRAPH_REF="your graph here"': 您的Apollo GraphOS图引用（例如 'my-graph@current'）。
- '--env APOLLO_KEY="your key here"': 您的Apollo GraphOS API密钥。
- 'ghcr.io/apollographql/apollo-runtime:latest': 要运行的Docker镜像名称和标签。
'notes': 额外说明，指导用户如何替换占位符。

高级配置（通过本地文件）： 如果您需要配置API模式、持久化查询清单或操作集等，可以创建本地配置目录（例如'my_config'），并将相关文件（如'api_schema.graphql'、'persisted_queries_manifest.json'、'custom_scalars.graphql'或'operations'文件夹）放入其中。然后在运行Docker命令时通过'-v'参数挂载此目录：

-v /path/to/my_config:/config

例如，挂载整个配置目录： 'docker run -v /absolute/path/to/my_config:/config ... ghcr.io/apollographql/apollo-runtime:latest' 或仅挂载特定文件： 'docker run -v /absolute/path/to/my_schema.graphql:/config/api_schema.graphql ... ghcr.ol/apollographql/apollo-runtime:latest'

基本使用方法

准备环境： 确保您的系统已安装Docker。
获取API密钥和图引用： 从Apollo GraphOS Studio获取您的图（Graph）的引用（GraphRef）和API密钥。
运行服务器： 执行上面“服务器配置”中提供的'docker run'命令，替换掉'APOLLO_GRAPH_REF'和'APOLLO_KEY'的占位符。
连接LLM客户端： 一旦容器成功启动，您的LLM客户端（或任何支持MCP协议的客户端）即可连接到'http://localhost:5050/mcp'路径与MCP服务器进行通信，获取上下文信息或调用工具。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息