本页说明如何在 Anthropic Messages API 中通过 MCP Connector 接入已经启动的 ShardingSphere-MCP HTTP Server。ShardingSphere-MCP 是 Apache ShardingSphere 提供的 MCP Server,用于把数据库元数据访问、受控 SQL 查询和数据库治理能力暴露给支持 MCP 的 AI 客户端和平台。
适用场景
- 适合在 Anthropic Messages API 中直接挂接远程 ShardingSphere-MCP,而不单独实现 MCP client。
- 适合在 Claude API 请求中按需暴露 ShardingSphere-MCP 的元数据查询、受控查询、规则规划和接入前预检能力。
- 接入完成后,可以在 Claude 会话中查看逻辑库中的表、查看表结构,或调用
database_gateway_validate_runtime_database对已经配置的 runtime database 进行接入前校验。
前置条件
- 已按快速开始启动 HTTP MCP Server。
- 只暴露可被 Anthropic Messages API 访问且已受保护的远程 HTTPS endpoint。ShardingSphere-MCP 内置 HTTP Server 不提供认证或授权。
- 远程平台接入时,应将 ShardingSphere-MCP 放在受信网关或反向代理后面,由外层组件提供 TLS 终止、身份认证、 授权策略、网络访问控制和审计日志。 安全边界见部署说明和配置说明。
- 该受保护的远程 endpoint 需要支持
Streamable HTTP或SSE。 - 已准备 Anthropic API Key。
- 当前 MCP Connector 版本要求携带
anthropic-beta: mcp-client-2025-11-20请求头。 - 如果受保护的远程 endpoint 或网关使用 OAuth 或 Bearer 认证,需要提前准备可传入
authorization_token的访问令牌。
接入步骤
配置接入
先将 SHARDINGSPHERE_MCP_REMOTE_URL 设置为受信网关对外发布的受保护远程 endpoint。
在 Messages API 请求中,先用 mcp_servers 声明 ShardingSphere-MCP,再在 tools 数组里添加与之对应的 mcp_toolset。最小示例如下:
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: mcp-client-2025-11-20" \
-d @- <<EOF
{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "Use ShardingSphere-MCP to inspect the tables in the logic database."
}
],
"mcp_servers": [
{
"type": "url",
"url": "${SHARDINGSPHERE_MCP_REMOTE_URL}",
"name": "shardingsphere"
}
],
"tools": [
{
"type": "mcp_toolset",
"mcp_server_name": "shardingsphere"
}
]
}
EOF
如果受保护的远程 endpoint 或网关使用 OAuth 或 Bearer 认证,应从受保护来源读取令牌,并在创建请求时向 mcp_servers 条目增加 authorization_token。
如果只想暴露一部分工具,可以在 mcp_toolset 中使用 default_config 和 configs 做 allowlist 或 denylist。例如,把默认值设为禁用,再显式启用少量工具:
{
"type": "mcp_toolset",
"mcp_server_name": "shardingsphere",
"default_config": {
"enabled": false
},
"configs": {
"database_gateway_search_metadata": {
"enabled": true
},
"database_gateway_validate_runtime_database": {
"enabled": true
}
}
}
验证接入成功
识别成功:
- 先用一条最小请求确认
mcp_servers与mcp_toolset已正确配对,没有触发服务名不匹配或 toolset 悬空错误。
调用成功:
- 在 Claude 会话中执行一条最小验证任务,例如:
- 查看
logic_db中有哪些表。 - 查看
orders表的列和索引。 - 对已经配置的 runtime database 调用
database_gateway_validate_runtime_database。
- 查看
- 如果 Claude 能返回来自 ShardingSphere-MCP 的工具结果,说明接入已经生效。
如果接入失败,优先检查:
- 是否携带了
anthropic-beta: mcp-client-2025-11-20请求头。 mcp_servers中的name和mcp_toolset中的mcp_server_name是否严格一致。- 远程地址是否为 Anthropic 平台可访问且已受保护的 HTTPS MCP endpoint,而不是本地
127.0.0.1地址或直接暴露的未认证内置 HTTP Server。
注意事项
- Anthropic MCP Connector 当前只支持远程 HTTP MCP Server,不支持本地
STDIO进程。 - 当前平台侧只支持 tool calls,不提供完整 MCP 资源面接入。
- 默认情况下
mcp_toolset会启用远程 MCP Server 暴露的全部工具。对于只读助手或受控试用环境,建议显式禁用不需要的写入类工具。 - 该功能当前要求
anthropic-beta: mcp-client-2025-11-20请求头;如果官方更新 beta 版本,需要同步调整文档与调用配置。 - 本页只说明 Anthropic 平台 API 接入方式。若希望在 Claude Code CLI 中接入,请参考 Claude Code。
- 具体可用任务和使用边界见能力清单。
参考资料
相关文档
官方参考
本文来自 Apache ShardingSphere 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。
