mcpField
C
cloudkb

cloudkb

本地服务
github.com/CloudCorpRecords记忆与知识02 周前更新
代码仓库

关于 cloudkb

cloudkb 是面向 Amazon Bedrock 用户的 MCP 服务，可管理知识库与数据源、处理摄取任务并执行检索。它覆盖控制面和运行时数据面请求，但不包含创建、更新或删除知识库等生命周期操作。

主要功能

  1. 01列出并查看知识库和数据源
  2. 02查看摄取任务
  3. 03启动或停止摄取任务
  4. 04检索及检索生成

适用场景

  1. 01查看 Bedrock 知识库和数据源
  2. 02检查或管理摄取任务
  3. 03针对知识库执行检索或检索生成

MCP 相关

以 stdio MCP 服务提供 10 个工具，供 MCP 客户端调用 Bedrock Agent 控制面和 Agent Runtime 数据面请求。调用需要 AWS 凭证；SigV4 签名须通过注入的 signer 或 executor 提供。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-cloudkb": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/cloudkb"
      ]
    }
  }
}
启动命令npx -y @reneturcios/cloudkb

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/cloudkb0.1.0
ocighcr.io/cloudcorprecords/cloudkb:0.1.0

工具

10

收录的工具列表 · 更新于 1 周前

参数类型必填说明
next_tokenstring否上一次列表调用返回的分页令牌，用于获取下一页。
max_resultsnumber否单页中要返回的知识库最大数量。

详细介绍

cloudkb

将 Amazon Bedrock 知识库作为 MCP 工具。cloudkb 是对 AWS Bedrock 知识库 MCP 服务核心功能的洁净室重建，采用新名称：工具名称和文档所述的 REST 请求格式保持一致，代码全新编写，不使用复制的品牌元素。

工具（核心子集，共 10 个）

list_knowledge_bases、get_knowledge_base、list_data_sources、 get_data_source、list_ingestion_jobs、get_ingestion_job、 start_ingestion_job、stop_ingestion_job、retrieve、 retrieve_and_generate。

前 8 个工具用于构造 Bedrock Agent（控制平面）请求； retrieve 和 retrieve_and_generate 用于构造 Bedrock Agent Runtime （数据平面）请求。请求构造功能真实可用并经过单元测试；每次调用都会通过可注入的执行器接口。

此子集不包含：知识库和数据源的创建、更新与删除生命周期，分块配置，Agent 和别名，流程， 提示词，护栏，评估任务，模型调用和会话。

设置

export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...
export AWS_REGION=us-east-1   # optional, this is the default

如果没有凭证，每次工具调用都会失败，并显示包含 AWS_ACCESS_KEY_ID 的错误。

明确说明签名方面的缺口： 此次重建未实现 SigV4 签名。签名由可注入的签名器/执行器 钩子处理；如果存在凭证但未注入签名器，调用会失败并显示 SigV4 signing not configured: inject a signer/executor，而不会发送未签名的请求。

CLI

npx @reneturcios/cloudkb list_knowledge_bases '{}'
npx @reneturcios/cloudkb retrieve '{"knowledge_base_id":"KB1","query":"refund policy"}'
npx @reneturcios/cloudkb mcp        # stdio MCP server

每个工具名称都是一个子命令，接收一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "cloudkb": {
      "command": "npx",
      "args": ["-y", "@reneturcios/cloudkb", "mcp"],
      "env": { "AWS_ACCESS_KEY_ID": "...", "AWS_SECRET_ACCESS_KEY": "...", "AWS_REGION": "us-east-1" }
    }
  }
}

Docker

docker run -i -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY ghcr.io/cloudcorprecords/cloudkb

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。