Mira MCP Server

关键词

模型上下文资源管理工具调用提示模板JSON-RPC

使用说明（Markdown 格式）

  • 项目简介 Mira 是一个完整的 MCP 服务器实现，负责托管和管理 Resources（资源）、Tools（工具）以及 Prompts（提示模板），并通过 JSON-RPC 与客户端进行请求与响应，提供会话管理、能力声明和多传输协议支持等能力，满足 Claude Code 等 LLM 客户端对上下文服务的需求。

  • 主要功能点

    • 资源与数据访问：持久化存储与查询资源、记忆、文档等上下文信息，支持本地化存储。
    • 工具注册与执行：注册第三方工具，LLM 可通过服务器调用外部功能。
    • Prompts 定义与渲染：集中管理 Prompt 模板，支持自定义的交互模式，便于 LLM 产生更贴合场景的对话。
    • JSON-RPC 服务：服务器端按 MCP 标准暴露请求/响应接口，客户端通过 JSON-RPC 进行通信。
    • 会话管理与能力声明：管理会话、能力清单，提供可扩展的插件化能力。
    • 多传输协议支持：结合标准 MCP 流式 I/O、HTTP、STDIO 等传输方式，便于不同客户端接入。
    • 本地化依赖与离线回退：在没有外部服务密钥时，提供 heuristics 回退，降低对外部 API 的依赖。
    • 安全与拓展性：通过配置化服务器发现与连接、 Bearer Token 的可选认证、以及可扩展的工具集成点，提升安全性和扩展性。

  • 安装步骤

    1. 选择安装方式之一：
      • 快速安装脚本（推荐）： 运行 install 脚本后， Mira 自动安装并配置 Claude Code 插件及所需依赖。
      • 手动安装（源码构建）：
        • 使用 Rust 构建并得到 mira 二进制文件： cargo build --release
        • 运行 mira serve 启动 MCP 服务器。
    2. 运行 MCP 服务器
      • 通过命令 mira serve 启动 MCP 服务器（具体命令可能因构建产物名称而略有差异，参考实际构建输出）。
    3. 配置 Keys（可选）
      • 根据需要配置 DeepSeek、Gemini 等外部服务的 API 密钥，通过 ~/.mira/.env 或等效环境变量提供。
    4. 配置 MCP 客户端连接 Mira
      • MCP 客户端需要知道 Mira 的启动命令与参数以建立连接（参考下文的配置示例）。

  • 服务器配置（MCP 客户端需要的配置信息示例） 说明：以下信息用于客户端在 MCP 客户端中注册 Mira 作为一个 MCP 服务器。客户端无需了解服务器内部实现细节，只需知道服务器名称及启动命令与参数即可连接。

    服务器名称：mira 启动命令（command）：mira 参数（args）：serve

    JSON 配置示例（用于 MCP 客户端配置文件）： { "mcpServers": { "mira": { "name": "mira", "command": "mira", "args": ["serve"] } } }

    说明：

    • server name 对应在 Mira 的实现中作为唯一标识符使用，便于多个 MCP 服务器的并行管理。
    • command 与 args 指定如何启动 Mira MCP 服务器实例，客户端将据此启动并连接。
    • 该配置仅用于 MCP 客户端连接 Mira 服务器，Mira 服务器本身无需将配置信息暴露给客户端。

  • 基本使用方法

    • 启动与接入
      • 启动 Mira MCP 服务器（本地开发环境）：运行 mira serve
      • MCP 客户端按照提供的配置启动并连接 Mira 服务器，建立 JSON-RPC 通道
    • 常用操作
      • 通过 MCP 客户端向 Mira 服务器发送资源读取、工具调用、Prompts 获取等请求
      • Mira 服务器返回标准的 JSON-RPC 响应，以及必要的通知
    • 运行与扩展
      • Mira 提供多种传输模式，结合实际部署场景可启用 STDIO、WebSocket、SSE 等传输层
      • 根据需要开启/关闭外部密钥提供、启用 Hook 与 Invoker 以及外部 MCP 服务的对接
    • 发展路线
      • 通过插件/扩展模块添加新的 Tools、Prompts、Resources
      • 拓展跨服务器工具对接、增强型工具安全性与访问控制

  • 关键词 模型上下文, 资源管理, 工具调用, 提示模板, JSON-RPC

  • 分类ID 6

服务器信息

访问项目