AGS Extend SDK MCP Server

AGS Extend SDK MCP Server

一个模型上下文协议 (MCP) 服务器，为 AI 助手（VS Code Copilot、Cursor、Claude、Gemini、Antigravity）提供 AccelByte Extend SDK 作为额外上下文——使它们能够回答有关 SDK 的问题并生成正确的 Extend SDK 代码。

它能做什么

• 搜索 Extend SDK 符号（函数和模型），可按名称、标签或描述进行搜索（模糊匹配）
• 描述 特定符号——参数、字段、导入、示例、返回类型、所需权限
• 脚手架 通过 create-extend-app 提示从模板仓库创建一个新的 Extend 应用

它为 四种语言——C#、Go、Java 和 Python 提供 SDK 参考。你可以通过 URL 路径为每个连接选择语言（参见选择你的语言）。

AccelByte 为你托管 Extend SDK MCP Server——你无需在本地安装或运行任何东西。只需将你的 AI 助手指向你所用语言的托管 MCP URL。无需登录：服务器仅公开只读的 SDK 参考数据。想自己运行？参见本地运行与自托管。

---

快速安装

将此粘贴到你的 AI 编码助手中——它会获取安装指南，问你几个问题，并为你配置好一切：

Install the AGS Extend SDK MCP server for me. Fetch and follow the instructions at
https://raw.githubusercontent.com/AccelByte/ags-extend-sdk-mcp-server/refs/heads/master/INSTALL.md

适用于 VS Code Copilot、Cursor、Claude Code、Antigravity 和 Gemini CLI。

Claude Desktop 用户： 最简单的路径是 设置 → 连接器 → 添加自定义连接器（名称：extend-sdk，URL：你的 MCP URL）——无需 AI 安装程序。参见下方的 Claude Desktop。

如果你想使用上面的快速安装提示，请先切换到 Code 标签页（Chat 和 Cowork 无法编辑你的配置文件）。

想自己动手？参见下方的手动安装。

---

手动安装

步骤 1：选择你的语言并获取你的 URL

MCP URL 是托管服务器的基本 URL 后跟 /extend-mcp/{language}：

https://<mcp-server-host>/extend-mcp/{language}

语言	URL 路径
C#	/extend-mcp/csharp
Go	/extend-mcp/go
Java	/extend-mcp/java
Python	/extend-mcp/python

• <mcp-server-host> 是你组织部署的主机——如果不确定，请咨询你的 AccelByte 管理员。
• 一个托管实例服务于所有语言。要稍后切换语言，只需更改末尾的路径段（例如 /extend-mcp/python → /extend-mcp/go）。请求未知语言会返回 HTTP 400。
• 不带语言的基本路径（/extend-mcp）提供服务器配置的默认语言。

没有托管实例？ 你可以使用 Docker 自行运行服务器——参见本地运行与自托管。

步骤 2：配置你的客户端

服务器使用 Streamable HTTP 传输。支持 HTTP 传输的客户端直接连接到 URL。仅支持 stdio 传输的客户端使用 mcp-remote 作为桥梁。

需要 mcp-remote？ 它通过 npx 运行，因此你需要 Node.js 18+ 且 npx 可用——使用 npx --version 验证。无需全局安装。

在下方看到 <URL> 的地方，替换为你在步骤 1 中获取的 URL。

Visual Studio Code (Copilot)

在你的工作区（或用户 settings.json）中的 .vscode/mcp.json：

{
  "servers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

如果你的客户端无法访问 HTTP 服务器，请切换为：{ "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }。

参见 VS Code MCP 文档。

Cursor

在你的工作区（或用户设置）中的 .cursor/mcp.json：

{
  "mcpServers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

如果你的客户端无法访问 HTTP 服务器，请切换为：{ "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }。

参见 Cursor MCP 文档。

Claude Code

claude mcp add --transport http extend-sdk <URL>

回退方案（仅 stdio 环境）：claude mcp add extend-sdk -- npx -y mcp-remote <URL>。

参见 Claude Code MCP 文档。

Antigravity

在你的项目根目录中的 mcp_config.json：

{
  "mcpServers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

如果你的客户端无法访问 HTTP 服务器，请切换为：{ "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }。

参见 Antigravity MCP 文档。

Gemini CLI

gemini mcp add --transport http extend-sdk <URL>

回退方案（仅 stdio 环境）：gemini mcp add extend-sdk -- npx -y mcp-remote <URL>。

参见 Gemini CLI MCP 文档。

Claude Desktop

选项 A — 自定义连接器（推荐）

1. 打开 设置 → 连接器 → 添加自定义连接器（在“自定义”区域下）。
2. 填写 名称：extend-sdk 和 远程 MCP 服务器 URL：你在步骤 1 中获取的 <URL>。
3. 保存。

看不到“添加自定义连接器”？ 某些团队版和企业版计划通过工作区策略禁用了自定义连接器。如果该选项缺失或呈灰色，请使用选项 B。

选项 B — mcp-remote 配置文件（回退方案）

编辑 claude_desktop_config.json：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "extend-sdk": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "<URL>"]
    }
  }
}

保存后重启 Claude Desktop。

---

使用工具

连接后，你的助手就可以访问这些工具。在你助手的聊天中，尝试下面的示例提示——在请求时授予运行工具的权限。

search-symbols

按名称、标签或描述搜索 Extend SDK 符号，支持模糊匹配。返回分页的摘要列表。

“搜索与用户相关的符号” · “查找库存的符号”

describe-symbols

通过 ID 获取特定符号的完整详细信息——字段、参数、导入、示例用法、返回类型和所需权限。

“描述 AdminCreateUser@iam 和 User@iam 符号”

create-extend-app

一个提示模板，用于克隆 Extend 应用模板仓库并打开它（如果可用，则在 Dev Container 中），以便你可以从一个可工作的示例开始。

调用 create-extend-app 提示，并按照场景/模板/语言补全进行操作。

[!TIP] 使用此 MCP 服务器编码时，请从 Extend SDK 入门示例或 Extend 应用模板开始，而不是从空白项目开始，并添加相关的源文件作为上下文以获得更好的结果。

---

自行运行

想本地运行服务器（stdio）或自行托管 HTTP 服务器？参见 本地运行与自托管，了解 Docker 用法、环境变量、HTTP 端点、冒烟测试、从源代码开发以及发布镜像。

---

故障排除

工具调用失败 / 服务器返回 400

检查你 URL 路径中的语言。它必须是 csharp、go、java 或 python 之一（例如 /extend-mcp/go）。未知语言会返回 HTTP 400。

客户端无法连接到 HTTP URL

某些客户端仅支持 stdio 传输。将该客户端切换到步骤 2 中显示的 mcp-remote 桥接配置。它需要 Node.js 18+ 且 npx 可用（npx --version）。

“连接被拒绝”或主机不可达

确认 <mcp-server-host> 和完整 URL 是否正确（咨询你的 AccelByte 管理员），以及你的网络是否可以访问它。

---

文档

• 安装指南 — 遵循快速安装提示；可独立阅读
• 本地运行与自托管 — Docker、环境变量、HTTP 端点、开发以及发布镜像
• Postman 集合 — search-symbols 和 describe-symbols 的导入和 Newman 冒烟测试说明

贡献

此仓库按原样发布。对于错误报告和问题，请提交 issue。