Ags Extend Sdk Mcp Server

AGS Extend SDK MCP 服务

一个模型上下文协议（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 服务 — 你无需在本地安装或运行任何内容。只需将 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 用户： 最简单的方法是 Settings → Connectors → Add custom connector（名称：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）

工作区中的 .vscode/mcp.json（或用户 settings.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. 打开 Settings → Connectors → Add custom connector（位于 “Customize” 区域）。
2. 填写 Name：extend-sdk 和 Remote MCP server URL：填入步骤 1 中的 <URL>。
3. 保存。

看不到 “Add custom connector”？ 部分 Team 和 Enterprise 计划会通过工作区策略禁用自定义连接器。如果该选项缺失或显示为灰色，请使用选项 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 提示词，并按提示选择场景、模板和语言。

提示

使用此 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）。

“Connection refused” 或无法访问主机

确认 <mcp-server-host> 和完整 URL 正确（请咨询你的 AccelByte 管理员），并确认网络能够连接到该主机。

---

文档

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

贡献

本仓库按现状发布。如需报告 Bug 或提出问题，请创建 issue。