Titan Memory MCP 服务器
使用说明（Markdown 格式）
-
项目简介
- Titan Memory MCP 服务器是 Titan Memory 体系中的后端服务，承担对资源（Resources）、工具（Tools）和提示模板（Prompts）的托管、注册与执行，以及对 Prompts 的渲染与渲染策略的管理。服务器通过 JSON-RPC 与 MCP 客户端进行通信，提供会话管理、能力声明与跨传输协议的支持，以给 LLM 客户端提供安全、可扩展的上下文服务。
-
主要功能点
- 统一的 MCP 服务入口：以 JSON-RPC 规范向客户端暴露资源、工具、Prompt 的读取、执行、渲染能力。
- 资源、工具、Prompts 的注册、管理与执行：包括对 28 种 MCP 工具的暴露、调用、结果返回等能力。
- 会话与能力声明：支持会话管理、权限、OAuth2 认证及范围校验。
- 多传输协议支持：理想场景下支持 Stdio、SSE、WebSocket 等传输通道，便于在不同环境中接入。
- 安全性与企业特性：OAuth2 授权、作用域控制、行为守护、 guardrails 等企业级能力。
- 配置化与可扩展性：通过配置文件和命令行参数灵活定制传输模式、端口、主机等。
-
安装步骤
- 克隆仓库并安装依赖
- 通过 npm 安装所需依赖并构建服务器。
- 构建
- 使用仓库提供的构建命令生成可运行的服务器二进制/输出。
- 启动 MCP 服务器
- 通过命令行启动，选择传输模式（stdio、http、dual），并可设置端口与主机。
- 连接测试
- 使用 MCP 客户端对接服务，按 MCP 协议进行 JSON-RPC 调用，测试资源、工具、Prompts 的读取与执行。
- 克隆仓库并安装依赖
-
服务器配置（JSON 配置示例，供 MCP 客户端使用） 说明：该配置用于 MCP 客户端了解如何连接 Titan Memory MCP 服务器。服务器端实际启动参数由 bin/titan-mcp.js 提供的选项决定，以下 JSON 配置仅描述连接信息与身份信息，便于 MCP 客户端准备阶段性连接信息。不要将敏感信息暴露在公开环境中。
{ "serverName": "TitanMemoryMCP", "transport": "http", "command": "node", "args": [ "bin/titan-mcp.js", "--http", "--port", "3000", "--host", "0.0.0.0" ], "description": "Titan Memory MCP 服务器，提供资源、工具、Prompts 的 JSON-RPC 接口", "endpoints": { "http": "http://0.0.0.0:3000" }, "auth": { "type": "oauth2", "provider": "Auth0 或等效实现", "requirements": [ "授权令牌在头部/查询参数中传递", "访问范围按工具所需进行校验" ] } }
-
基本使用方法
- 通过 MCP 客户端以 JSON-RPC 请求调用工具、读取资源、获取提示模板等。
- 常用操作包括：
- 读取资源：JSON-RPC 请求读取资源数据并返回。
- 调用工具：通过工具名称调用，传入相应参数，获取执行结果。
- 获取 Prompt：按需渲染或获取提示模板及上下文。
- 注意事项：
- 客户端需要与服务器端建立认证并传递有效的访问令牌。
- 根据需求选择合适的传输通道（stdio/SSE/WebSocket），确保与调用端兼容。
- MCP 协议实现要求服务器端对请求进行 JSON-RPC 形式的应答，包含 result 或错误信息。
-
运行与调试
- 本仓库提供了一个启动脚本 bin/titan-mcp.js，通过命令行参数可选择传输模式：
- 仅 stdio（默认）
- 启用 http（OAuth2 认证）
- 双模态同时运行
- 参考 README 中的详细说明与样例命令，结合实际环境配置 OAuth、端点与证书等安全要素。
- 本仓库提供了一个启动脚本 bin/titan-mcp.js，通过命令行参数可选择传输模式：
-
重要说明
- 该实现包含 28 种 MCP 工具、5 层记忆体系、Cortex 分类管线、跨项目学习、以及多种 MIRAS 增强组件等特性，覆盖 MCP 服务器应具备的资源、工具、提示的注册、执行及渲染能力，以及面向 LLM 的上下文服务能力。
- 以上描述的能力点均来自仓库内的实现与文档（包括 bin/titan-mcp.js、README 的工具列表与 Enterprise 配置等）。