mcpField
C
cloudsession

cloudsession

本地服务
github.com/CloudCorpRecords云与基础设施01 周前更新
代码仓库

关于 cloudsession

cloudsession 是用于管理本地 AWS 会话上下文和执行计划的 MCP 服务，适合无需调用 AWS API 的轻量状态管理。会话与有序计划保存在内存中，由调用方显式推进。

主要功能

  1. 01启动、查看和结束会话
  2. 02设置 AWS 配置文件与区域
  3. 03列出支持的区域
  4. 04创建和查看有序计划
  5. 05显式推进计划步骤
  6. 06状态仅在服务进程存续期间保留

适用场景

  1. 01跟踪本地 AWS 配置文件和区域上下文
  2. 02安排有序的执行步骤
  3. 03通过单个 MCP 服务进程管理多步状态

MCP 相关

向 MCP 客户端提供九种会话和计划状态管理工具。这些工具操作本地内存状态，不会调用 AWS API。

配置

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

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

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

安装包
npm@reneturcios/cloudsession0.1.0
ocighcr.io/cloudcorprecords/cloudsession:0.1.0

工具

9

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

参数类型必填说明
regionstring否新会话的 AWS 区域，例如 "us-east-1"。必须是已知区域；省略时默认为 "us-east-1"。
profilestring否要与新会话关联的 AWS 配置文件名称。省略时默认为 "default"。

详细介绍

cloudsession

将本地 AWS 会话和计划状态作为 MCP 工具。cloudsession 是对 AWS core MCP 服务中会话／计划元核心的全新实现，采用新名称：真实的本地状态逻辑、全新代码，不复制品牌内容。此子集中的工具不会调用任何 AWS API——会话是携带配置文件名称和区域的本地上下文，计划则是由调用方显式推进的有序步骤列表。

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

start_session、get_session_info、end_session、set_region、 set_profile、list_regions、create_plan、advance_plan_step、 get_plan。

会话默认使用配置文件 default 和区域 us-east-1，除非另行指定；ID 按确定性规则生成（session-1、plan-1……），并依据经过整理的静态区域列表（29 个区域）验证区域。结束会话后，会阻止进一步修改，但仍可读取该会话。计划会将每个步骤标记为待处理或已完成；推进最后一步会使计划完成，推进已完成的计划则会报错。状态仅在服务器进程运行期间保存在内存中——重启后不会保留任何内容。

此子集中不包含：AWS API 代理／调用工具、凭证和 SSO 登录流程、文档搜索辅助工具、提示词模板，以及任何调用实时 AWS 服务 API 的工具。

设置

无需凭证或环境变量。

CLI

npx @reneturcios/cloudsession list_regions '{}'
npx @reneturcios/cloudsession start_session '{"region":"eu-west-1"}'
npx @reneturcios/cloudsession mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。请注意，每次 CLI 调用都会使用全新的存储，因此多步会话／计划流程应在 MCP 服务中进行，该服务会在整个生命周期内保留同一个存储。

MCP 客户端配置

{
  "mcpServers": {
    "cloudsession": {
      "command": "npx",
      "args": ["-y", "@reneturcios/cloudsession", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/cloudsession

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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