SimpleMem MCP Server

使用说明

  • 项目简介 SimpleMem MCP 服务器实现了 MCP 协议,作为为大型语言模型客户端提供上下文与功能服务的后端。它支持资源管理、工具注册与执行、以及 Prompt 模板的渲染和输出,具备会话管理与多租户隔离能力,并可通过多种传输协议与客户端通信,适用于云端或本地部署的对话代理场景。
  • 主要功能点
    • MCP 协议处理:支持 JSON-RPC 2.0 风格的请求与响应,以及会话管理与通知/响应通知
    • 资源与工具管理:提供资源查询、读取、以及工具调用能力,方便 LLM 客户端调用外部功能
    • Prompt 处理与渲染:定义并渲染 Prompt 模板,支持可定制的 LLM 交互模式
    • 会话与多租户:基于用户隔离实现多租户数据表,确保数据独立性
    • 多传输协议:支持 Streamable HTTP、HTTP/REST 及 SSE(服务器推送)等传输模式,提升与不同客户端的互操作性
  • 安装与运行
    • 克隆仓库并进入 MCP 相关目录
    • 安装依赖(例如通过 requirements.txt 或相应的 dependencies)
    • 配置环境变量(OpenRouter/OpenAI、Embeddings、数据库路径等)并准备证书/密钥
    • 启动服务(示例命令:uvicorn 或 通过 MCP/run.py 启动,具体端口与主机根据配置设定)
  • 服务器配置(客户端必需,不作为代码示例呈现) MCP 客户端需要知道 MCP 服务器的启动指令与连接信息(server name、command、args 等),以建立连接并通过 JSON-RPC 进行通信。以下为示例配置要素(请以 JSON 格式提供给客户端配置,无需包含代码): { "serverName": "simplemem-mcp-server", "command": "uvicorn", "args": ["server.http_server:app", "--host", "0.0.0.0", "--port", "8000"] } 注释:实际参数以服务器启动方式为准,客户端只需知道服务器名称、启动命令及参数,便可连接并建立会话。
  • 基本使用方法
    1. 通过注册获取访问令牌(如需鉴权):向 MCP 服务器的认证端点请求注册,获取 token
    2. 初始化会话:使用 initialize 请求建立会话并获取会话 ID
    3. 资源与工具交互:通过 resources/list/read、tools/list/call 等接口进行交互
    4. 发送文本查询:以 JSON-RPC 形式发送查询请求,服务器返回结构化响应与通知
    5. 结束会话:发送删除会话请求并清理资源

服务器信息