AMS

使用说明

• 项目简介
  • AMS 是一个基于 MCP 的后端服务器，实现标准的资源管理、工具注册/执行以及提示模板渲染等核心能力，专注于为 LLM 客户端提供可审计、有记忆、可扩展的上下文服务。服务端通过 JSON-RPC 与客户端通信，支持读取资源、调用工具、获取与渲染提示模板等能力，并内置会话管理、 Merkle/audit 等安全与可追溯性机制。
• 主要功能点
  • MCP 服务端实现：接收和处理 MCP 的 JSON-RPC 请求，返回标准化的 JSON-RPC 响应。
  • 资源与数据访问：托管并提供对 Resources 的访问能力（如 Roadmaps、Roadmap 内容等）。
  • 工具注册与执行：注册 75+ MCP 工具，允许 LLM 客户端远程调用外部功能。
  • 提示模板与渲染：提供对 Prompts 的管理与渲染能力，支持多种交互模式。
  • 会话与审计：内置会话管理、哈希链、Merkle 验证与审计动作记录，确保可溯源性与安全性。
  • 数据持久化与迁移：使用 SQLite 作为主数据存储，包含迁移与历史数据能力。
  • 审计与哈希链相关域：Thought、Merkle、Audit、Context 等域实现，提供端到端的完整审核链。
  • 自主管道与管控：Autonomous Pipeline、GSD（Get Shit Done）等模块，支持任务导向的自动化工作流与数据分析。
  • 多传输协议与中间件：内置 Stdio 传输、Circuit Breaker、Retry、Rate Limiter 等中间件，支持稳健的服务治理。
• 安装与运行
  • 依赖与环境
    • 该项目需要 Node.js 环境，及仓库内的依赖包（通过 npm 或 pnpm/yarn 安装）。
    • 需要准备一个工作目录（AMS_ROOT），服务器需要读取该根目录下的数据与配置。
  • 启动步骤（简要）
    • 安装依赖：在仓库根或项目路径执行安装命令。
    • 设置环境变量：AMS_ROOT 指向 AMS 的根目录，例如 "/path/to/AMS"。
    • 启动服务器：执行 Node 命令运行 AMS/projects/unified-mcp/src/server.js。
  • MCP 客户端配置说明
    • MCP 客户端需要与 AMS 的 MCP 服务器建立连接，配置包含服务器标识、启动命令和参数等信息。下面给出示例配置（JSON 格式，便于粘贴使用，实际路径请替换为你的环境路径）。
    • 配置示例（用于 MCP 客户端接入 AMS）: { "mcpServers": { "ams": { "name": "ams", "command": "node", "args": ["/path/to/AMS/projects/unified-mcp/src/server.js"], "env": { "AMS_ROOT": "/path/to/AMS" } } } }
    • 说明
      • 该配置指定了 MCP 服务器名称为 ams，启动命令为 node，启动脚本路径为 AMS 项目中的 server.js，环境变量 AMS_ROOT 指向 AMS 的根目录。客户端使用该配置即可通过 MCP 标准协议向 AMS 服务器发起请求。
• 服务器基本用法
  • 启动后服务器将对外提供 MCP 能力，包括工具列表、资源读取、工具调用等能力。LLM 客户端通过 MCP 的 JSON-RPC 调用与 AMS 进行交互，服务器端返回 JSON-RPC 形式的响应。
  • 常见调用场景
    • 列出所有工具
    • 获取资源列表
    • 读取特定资源内容
    • 调用某个工具并获得结果
• 备注
  • MCP 客户端只需要通过上述配置来连接服务端，AMS 服务器端实现了核心的 MCP 协议处理、域逻辑、并发控制与审计能力。无需修改客户端即可直接对接。