AWS Knowledge 远程 MCP 服务器 – 官方端点、工具列表与一键连接指南
AWS Knowledge 官方托管的远程 MCP 服务器。AWS 官方全托管知识库 MCP,为 AI 代理提供最新 AWS 文档、API 参考与架构指导。公开免鉴权,开箱即用。
本页收录其官方远程端点、传输协议、认证方式、全部工具 Schema、实时可用性拨测与安全审计结果,并为 Cursor、Claude Code、VS Code、ChatGPT 等 10 大客户端提供一键接入指引。
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"aws-knowledge": {
"url": "https://knowledge-mcp.global.api.aws"
}
}
}claude mcp add --transport http aws-knowledge https://knowledge-mcp.global.api.aws
Or add to .vscode/mcp.json:
{
"servers": {
"aws-knowledge": {
"type": "http",
"url": "https://knowledge-mcp.global.api.aws"
}
}
}- Open Settings → Connectors (Integrations) → Add Custom Connector.
- Paste the endpoint URL:
https://knowledge-mcp.global.api.aws - No authentication needed — tools are available immediately.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"aws-knowledge": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://knowledge-mcp.global.api.aws"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"aws-knowledge": {
"serverUrl": "https://knowledge-mcp.global.api.aws"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"aws-knowledge": {
"url": "https://knowledge-mcp.global.api.aws"
}
}
}Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.aws-knowledge] url = "https://knowledge-mcp.global.api.aws"
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"aws-knowledge": {
"type": "streamableHttp",
"url": "https://knowledge-mcp.global.api.aws"
}
}
}Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"aws-knowledge": {
"httpUrl": "https://knowledge-mcp.global.api.aws"
}
}
}🧰 AWS Knowledge MCP 工具与 Schema(5)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| aws___read_documentation ~681 tok | 🟢 Read | Fetch full AWS doc pages as markdown. `search_documentation` already returns verbatim page chunks, so don't re-read a URL whose chunk you already have to "confirm" or "round out" an answer -- the chunk is the real page text; treat it as authoritative. Reading the full page is justified ONLY when the chunks genuinely lack the content: - an enumeration or aggregation ("list all X", "how many X") needs the complete set and the chunks show only part of it; - no search result is on-topic after refining the query, and a known doc URL would have the answer. Otherwise, answer from the chunks. Use exact URLs from `search_documentation`; don't guess slugs. Input: `requests: [{url, max_length?, start_index?}]`. Batch 2-5. - `max_length` default 10000. - `start_index` default 0; use prior `end_index` to continue, TOC offset to jump. Allow-listed prefixes: docs.aws.amazon.com; aws.amazon.com (not /marketplace); repost.aws/knowledge-center; docs.amplify.aws; ui.docs.amplify.aws; github.com/{aws-cloudformation/aws-cloudformation-templates, aws-samples/{aws-cdk-examples, generative-ai-cdk-constructs-samples, serverless-patterns}, awsdocs/aws-cdk-guide, awslabs/aws-solutions-constructs, cdklabs/cdk-nag} (README on `main`); constructs.dev/packages/{@aws-cdk-containers, @aws-cdk, @cdk-cloudformation, aws-analytics-reference-architecture, aws-cdk-lib, cdk-amazon-chime-resources, cdk-aws-lambda-powertools-layer, cdk-ecr-deployment, cdk-lambda-powertools-python-layer, cdk-serverless-clamscan, cdk8s, cdk8s-plus-33}; strandsagents.com/latest/documentation/docs/; karpenter.sh/docs/; Amazon Braket: {amazon-braket-sdk-python, amazon-braket-schemas-python, amazon-braket-default-simulator-python, amazon-braket-pennylane-plugin-python, amazon-braket-algorithm-library, qiskit-braket-provider, autoqasm, qirtoqasm}.readthedocs.io and github.com/amazon-braket/* (blob/tree/raw). Output: SUCCESS -- markdown + `total_length, start_index, end_index, truncated, redirected_url?` (truncated includes TOC with char ranges). ERROR -- `error_code` in {not_found, invalid_url, throttled, downstream_error, validation_error}. | requests: array |
| aws___search_documentation ~426 tok | 🟢 Read | AWS docs search. Each result's `context` is verbatim page text -- a real chunk of the actual page, not a short snippet -- and usually already contains the answer, so answer directly from it. Use `read_documentation` only when the chunks genuinely lack the needed detail. Pick ONE topic. Add a 2nd ONLY if query genuinely spans domains. Extra topics dilute ranking. - reference_documentation -- API/SDK/CLI specs, config params - current_awareness -- new/released/announced - troubleshooting -- errors, "how to fix" (NOT for conceptual/feature questions) - amplify_docs -- Amplify (+ language) - cdk_docs -- CDK concepts/guides - cdk_constructs -- CDK code samples, L3 - cloudformation -- CFN/SAM templates - strands_docs -- Strands Agents SDK (its Skills/agents concepts go here, NOT agent_skills) - agent_skills -- this tool's guided skills (load via `retrieve_skill`) - general (default) -- architecture, best practices, tutorials, feature behavior Results: rank_order (lower=better), url, title, context (verbatim page chunk -- answer directly from it). | limit: integersearch_phrase*: stringtopics: array |
| aws___list_regions ~36 tok | 🟢 Read | Retrieve a list of all AWS regions. | — |
| aws___get_regional_availability ~557 tok | 🟢 Read | AWS resource availability per region. - Max 10 regions; multi-region needs `filters`; single-region supports `next_token`. - Status: isAvailableIn | isNotAvailableIn | isPlannedIn | Not Found. - Response key: products | service_apis | cfn_resources. Not for region counts/docs/vague queries -- use `search_documentation` / `list_regions`. Filter values must EXACTLY match AWS's catalog names; guessed, partial, or pluralized names are rejected ("values in filter parameter do not exist"). If unsure of the exact name, first call once for a single region with resource_type set and NO filters to list all valid names, then re-call filtering on the exact match. | regions: arrayresource_type*: stringfilters: arraynext_token: stringregion: string |
| aws___retrieve_skill ~176 tok | 🟢 Read | Retrieve an AWS skill (workflows, references). Returns SKILL.md, or `file` if given. Call `search_documentation` FIRST and copy `skill_name` verbatim -- it is an opaque registry ID. Never guess or fabricate `skill_name` or `file`. | file: stringskill_name*: string |
🛡️ 安全评级、质量与上下文 Token 审计
- No prompt-injection or hidden-character anomalies detected in tool descriptions
- Streamable HTTP primary endpoint (current 2025-03-26 transport)
- Public read-only-friendly endpoint — no credentials stored client-side
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
🔐 OAuth 2.1 与安全
- 认证方式
- 免密公开
- 动态客户端注册(DCR)
- —
- PKCE S256
- —
- 受保护资源元数据
- https://knowledge-mcp.global.api.aws/.well-known/oauth-protected-resource
📡 官方远程端点与传输协议
远程端点 https://knowledge-mcp.global.api.aws 采用 Streamable HTTP(流式 HTTP,2025-03-26 规范)。Streamable HTTP 在单一 POST 端点上完成 JSON-RPC 双向交互,是当前 MCP 规范推荐的传输方式,可直接被 Claude、Cursor、VS Code 等客户端以 URL 形式接入,无需 npx mcp-remote 桥接。
接入前可将端点粘贴至本站 在线 MCP Inspector 实测 initialize / tools/list 握手,确认真实协议行为。
🔐 认证与权限机制
认证方式为 免密公开(None)。完全免密公开,直接粘贴 URL 即可使用——适合文档检索与公开数据查询类场景。
🛡️ 上下文开销与安全审计
该服务端当前登记 5 个工具,全部定义合计约 1896 tokens,会在每次请求时注入模型系统提示词。安全评级为 A+,官方直营来源。工具名与 Schema 越精简,对上下文窗口的"税"越低;可用 feecalculator.app 估算每次调用的边际成本。
🧩 主流客户端快速接入
本站为 AWS Knowledge 生成了 Cursor / Claude Code / VS Code / ChatGPT / Windsurf / Kiro / Codex / Cline / Gemini 等 10 大客户端的专属配置——包括一键 deeplink、claude mcp add 命令与 JSON/TOML 片段。下方选择你的客户端即可查看 1 分钟接入步骤。代表性工具包括 aws___read_documentation、aws___search_documentation、aws___list_regions、aws___get_regional_availability、aws___retrieve_skill 等。
📖 AWS Knowledge 详解
AWS Knowledge — Remote MCP Server
AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. The remote endpoint means there is nothing to install — point your MCP client at the URL and start calling tools right away. Amazon Web Services operates and versions the server themselves, so tool coverage tracks their API surface as it ships.
Official AWS Knowledge Endpoint & Transport Architecture
- Endpoint URL:
https://knowledge-mcp.global.api.aws - Transport: Streamable HTTP
Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. AWS Knowledge does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
AWS Knowledge is public and unauthenticated — no OAuth, no API key, no headers. Any MCP client can connect and call its tools directly, which also makes it a great endpoint for smoke-testing your own MCP client or proxy.
All 3 cataloged tools are read-only — AWS Knowledge cannot mutate your account data, which makes it safe to connect broadly.
Common Troubleshooting & Connection Tips
- "Session expired" / stale
Mcp-Session-Id— just re-sendinitialize; stateless clients can ignore session headers entirely. - Global endpoint operated by AWS; no credentials or session management required.
🚀 如何接入 AWS Knowledge 远程 MCP
- 获取远程端点 — 复制官方端点 https://knowledge-mcp.global.api.aws。
- 写入客户端配置 — 在 Cursor 的 mcp.json / Claude Code CLI / 其他客户端中添加该 URL(见下方分客户端指南)。
- 授权并验证 — 保存配置后,在本站 Inspector 中运行 initialize 与 tools/list 验证连通性。
🔌 AWS Knowledge × 各客户端连接指南
❓ 常见问题
AWS Knowledge 远程 MCP 服务器是官方提供的吗?
本条目标记为「官方直营」。端点由 Amazon Web Services 官方运营,所有收录端点均经过真实 MCP initialize 握手验证。
如何在 Claude / Cursor 中连接 AWS Knowledge?
复制远程端点 https://knowledge-mcp.global.api.aws:Claude Code 执行 claude mcp add --transport http aws-knowledge https://knowledge-mcp.global.api.aws;Cursor 可直接使用本页的一键 deeplink 或在 ~/.cursor/mcp.json 中添加 { "mcpServers": { "aws-knowledge": { "url": "https://knowledge-mcp.global.api.aws" } } }。
连接时返回 401 或需要密钥怎么办?
该端点免密公开;若仍返回 401 请确认 URL 未拼写错误,并在 Inspector 中重试。
本地 stdio MCP 和这个远程 MCP 有什么区别?
本地 MCP 通过 npx/uvx 在你的机器上启动 stdio 子进程,依赖本地运行时且密钥以明文写入配置文件;远程 MCP 是 Amazon Web Services 托管的 HTTPS 端点,免安装、支持 OAuth 2.1 授权流,且同一端点可跨桌面与移动端复用。详见 本地 vs 远程 MCP 对比。