Cass Memory MCP 服务器

关键词

Model Context ProtocolJSON-RPC资源管理工具注册Prompt 模板

使用说明

  • 项目简介
    • cass-memory 是一个面向 AI 编码代理的上下文服务框架，内置对 MCP（Model Context Protocol）的支持，能够以标准化的 JSON-RPC 方式向客户端提供“资源（Resources）”数据访问能力、注册与执行“工具（Tools）”、以及渲染与管理“Prompt 模板（Prompts）”等能力，旨在为 LLM 客户端提供可扩展、可审计的上下文服务。
  • 主要功能点
    • MCP 核心能力
      • 通过 HTTP 提供 MCP 风格的请求/响应接口（JSON-RPC），实现对资源、工具、提示等的查询与操作。
    • 资源与工具管理
      • 托管和访问资源、注册并执行工具，支持客户端调用外部功能。
    • Prompt 模板
      • 定义、渲染与暴露可定制的提示模板，帮助 LLM 客户端在不同任务中获得一致的交互模式。
    • 会话与安全
      • 会话管理、能力声明、以及可选的跨代理 enrichment，具备权限控制（通过 MCP_TOKEN 机制）。
    • 本地化部署与扩展性
      • 设计为本地优先、可断网使用，具备插件化扩展点，支持多种传输协议（HTTP 为 MCP 服务端的默认实现）。
  • 安装步骤
    • 确保已安装 Bun 运行时
    • 获取代码并安装依赖
      • 克隆仓库并进入项目根目录
      • 运行 bun install
    • 构建与运行
      • bun run build
      • 启动 MCP 服务器（默认本地监听 127.0.0.1:8765）:
        • cm serve
      • 也可以自定义主机与端口：
        • cm serve --host 0.0.0.0 --port 9000
      • 如需要开启 Token 授权，请设置环境变量 MCP_HTTP_TOKEN，客户端需要在 Authorization: Bearer <token> 或 X-MCP-Token: <token> 中携带该令牌进行认证。
  • 服务器配置（MCP 客户端使用的配置示例，不用于直接编辑服务器端代码）
    • 客户端需要的最低信息（JSON 格式，供 MCP 客户端加载使用）： { "serverName": "cass-memory-mcp", "command": "cm", "args": ["serve", "--host", "127.0.0.1", "--port", "8765"] } 说明：
    • serverName：MCP 客户端在本地或远程注册的服务器名称，便于在多服务器环境中区分
    • command/args：启动服务器的命令与参数，此处对应本仓库默认的启动方式
    • 该配置仅作为 MCP 客户端的连接信息，不需要在内网中修改服务器端实现
  • 基本使用方法
    • 启动后，客户端可通过 JSON-RPC 请求调用以下示例方法（实际方法名以 MCP 定义与实现为准）：
      • tools/list：获取已注册工具列表
      • resources/list：获取可访问的资源列表
      • prompts/get：获取并渲染提示模板
    • 常用客户端交互模式：
      • 读取资源、调用工具、获取 Prompt 等资源并将结果返回给客户端
      • 支持会话管理、能力声明，以及在必要时进行跨代理 enrichment（需开启跨代理设置并获得相应授权）
  • 注意事项
    • 默认情况下服务器仅暴露本地接口，若需要公网接入，请在主机绑定和安全鉴权方面做好配置（如开启 HTTPS、设置强随机 Token、限定允许的客户端等）
    • MCP 客户端在集成时需遵循 JSON-RPC 协议，确保请求体正确、方法名与参数按约定传递

服务器信息

访问项目