Gcore MCP Server 是 Gcore 官方提供的 MCP（Model Context Protocol）服务器，用于让 LLM 助手通过工具调用与 Gcore Cloud API 进行交互。
用途
该服务器将 Gcore Cloud API 封装为 MCP 工具，使支持 MCP 的 LLM 客户端（如 Cursor IDE、Claude Code）能够直接操作 Gcore 云资源，例如管理虚拟机、网络、存储、AI 集群等。
主要能力
服务器提供多个预定义工具集，覆盖常见工作流：
- management：核心账户与项目管理
- instances：虚拟机操作
- baremetal：裸金属服务器操作
- gpu_baremetal：GPU 裸金属集群管理
- gpu_virtual：GPU 虚拟集群管理
- networking：网络、浮动 IP、负载均衡器
- security：安全组、SSH 密钥、机密
- storage：卷、文件共享
- ai：AI 集群
- ai_ml：AI/ML 推理服务
- billing：成本报告与账单信息
- containers：容器注册表
- cdn：CDN 资源、源站组、证书与缓存管理
- cleanup：删除与清理操作
- list：列表/只读操作
工具选择通过 GCORE_TOOLS 环境变量统一配置，支持三种模式：
- 工具集模式：使用预定义工具集名称，如 GCORE_TOOLS="instances,management"。
- 模式匹配模式：使用通配符匹配 Gcore SDK 中的工具名称，支持精确匹配（如 cloud.instances.create）、通配符匹配（如 cloud.、waap.）。
- 组合模式：混合工具集与模式，工具集定义优先于模式匹配。
默认情况下，HTTP 传输使用 management,instances 工具集，stdio 传输使用 management 工具集。
使用方式
与 Cursor IDE 集成
将服务器添加到 Cursor IDE 配置文件（~/.cursor/mcp.json）。
与 Claude Code 集成
将服务器添加到 Claude Code 配置文件（~/.claude.json）。设置 GCORE_TOOLS=* 可加载所有工具，Claude Code 的 Tool Search 功能会延迟加载工具模式，避免上下文膨胀。
临时运行
使用 uvx 命令可在临时环境中运行服务器，无需持久安装。例如运行主分支最新版本或指定版本（如 v0.1.1）。运行前需设置必要的环境变量（如 GCORE_API_KEY、GCORE_TOOLS 等）。
持久安装
使用 uv 将 gcore-mcp-server 安装为命令行工具，安装后命令全局可用。若未找到命令，可运行 uv tool update-shell 或确保 uv 的工具 bin 目录在 PATH 中。
本地开发与调试
推荐使用 MCP Inspector 进行调试和测试，它提供 Web 界面，可探索可用工具及其模式、测试工具调用、查看实时通信、调试认证与连接问题。
配置变量
必需：GCORE_API_KEY（获取方式见官方说明）。 可选：
- GCORE_BASE_URL：默认 "https://api.gcore.com"
- GCORE_CLOUD_PROJECT_ID：默认 "1"
- GCORE_CLOUD_REGION_ID：默认 "76"
- GCORE_CLIENT_ID：默认 "2"
- GCORE_ALLOWED_HOSTS：仅 HTTP 传输，逗号分隔的主机名列表，支持 glob 模式
- GCORE_ALLOWED_ORIGINS：仅 HTTP 传输，逗号分隔的浏览器源列表，支持 glob 模式
适用场景
适用于需要通过 LLM 助手管理 Gcore 云资源的开发者、运维人员，尤其是在 Cursor IDE 或 Claude Code 中集成云操作流程的场景。
限制
- 提供所有资源可能使部分 LLM 客户端过载，建议仅指定必要资源。
- HTTP 传输不认证客户端，任何能访问监听器的人均可使用服务器的 GCORE_API_KEY 调用所有已启用工具，应绑定到回环地址，不要暴露到不可信网络。
- HTTP 传输会验证 Host 和 Origin 头，防止 DNS 重绑定攻击。
- 不支持旧版 SSE 传输，GCORE_TRANSPORT=sse 会拒绝启动。
- 已知 FastMCP 限制：IPv6 字面量源（如 http://[::1]:3000）无法加入允许列表。
- 仅 gcore-mcp-server 入口点应用 HTTP 传输安全策略，通过其他运行器加载模块的 mcp 对象不应用。
