Temple Vault MCP 服务器
使用说明（Markdown 格式）：
- 项目简介 Temple Vault MCP 服务器是一套基于 MCP 的后端服务，提供标准的资源管理、工具执行和提示模板渲染接口，面向大语言模型客户端，通过 JSON-RPC 方式进行上下文提供、数据访问与外部功能调用。服务器具备会话管理、能力声明和多传输协议支持，旨在为 LLM 应用提供安全、可扩展的上下文服务框架。
- 主要功能点
- MCP 接口：注册并暴露 Resources、Tools、Prompts，统一以 temple:// 等 URI 表达上下文入口。
- Tools 与 Prompts：实现 recall_insights、check_mistakes、record_insight、record_learning、session_start 等工具与工作流提示，支持工具调用和会话驱动。
- Resources：提供例如 temple://welcome、temple://vault/manifest、temple://vault/stats 等上下文入口。
- 会话与治理：内置会话初始化、行动前检查、转化与签名等治理/审计机制，确保安全的上下文建模与传递。
- 传输协议：支持 stdio、SSE、streamable-http 等传输，便于本地桌面客户端和网页/云端客户端接入。
- 文件系统驱动：以纯文件系统为数据源实现索引、缓存与检索，提升可复现性与可审计性。
- 与 Claude/Memory Tool 集成：通过桥接层实现对 Claude Memory Tool 的协同工作，在本地 Vault 记忆系统中实现一致性治理。
- 安装与运行步骤
- 克隆仓库并进入项目根目录。
- 安装依赖（示例性步骤）：
- 确保系统已安装 Python 3.x 及 pip
- 安装 MCP 相关依赖（如 fastmcp 等）
- 安装本仓库所需的其它依赖（按仓库中的文档执行）
- 启动 MCP 服务器（示例命令，具体取决于运行的入口脚本）：
- 以 templaVault 的 MCP 服务端为例，可指定 Vault 路径与传输协议启动： python temple_vault/server.py --vault ~/TempleVault --transport sse --port 8000 备注：实际部署时可结合仓库内的 README 与入口脚本配置不同传输协议和端口。
- 传输与连接方式
- stdio：直接通过标准输入输出交互 JSON-RPC
- SSE/HTTP：适合网页客户端或远程客户端
- Claude Memory Tool 等外部工具可通过适配端进行集成
- 服务器配置（MCP 客户端连接信息，JSON 格式，非代码片段说明）
{
"server_name": "Temple Vault MCP Server",
"command": "python",
"args": ["-m", "temple_vault.server"],
"vault_path": "/home/你/TempleVault",
"transport": "sse",
"port": 8000,
"host": "0.0.0.0"
}
说明：
- server_name：服务器在 MCP 客户端中的标识名称
- command/args：启动服务器的命令及参数
- vault_path：MCP 服务器将使用的 Vault 根目录
- transport/port/host：客户端连接服务器所使用的传输协议与网络地址
- 注：客户端本身一般不需要执行服务器端代码，仅通过上述配置信息建立连接
- 基本使用方法
- 启动后，MCP 客户端可通过 JSON-RPC 请求读取资源、调用工具、获取 Prompts，以及订阅/接收通知。
- 常用操作包括：
- 读取资源：请求 temple://welcome、temple://vault/manifest 等资源
- 调用工具：recall_insights、record_insight、record_learning、get_spiral_context 等
- 获取/执行提示模板：session_start、before_action、session_end 等
- 集成 Claude Desktop 等工具时，可在配置中指定服务器端点并通过 MCP 路由进行交互