MoJoAssistant MCP 服务器

使用说明（Markdown 格式要点）

• 项目简介

  • MoJoAssistant MCP 服务器是一个面向 LLM 客户端的后端服务，按照 MCP 规范实现资源、工具、提示等核心能力的暴露与管理，支持多传输协议（HTTP/REST、STDIO 等），并提供会话管理、能力声明与扩展能力（如 OpenCode Manager、OAuth 2.1 认证等）。

• 主要功能点

  • MCP 核心能力：资源/知识管理、工具注册与执行、提示模板渲染与查询等，统一通过 MCP 请求/响应进行交互。
  • 多传输协议：HTTP/REST API 与 STDIO（以及潜在的 SSE/WebSocket 适配）。
  • 服务扩展：OpenCode Manager 多项目管理、多模型嵌入与 LLM 后端切换、私有本地 LLM 支持、基于 JSON-RPC 的工具调用。
  • 安全与认证：可配置的 OAuth 2.1、MCP API Key 认证，以及对 Claude Desktop 等客户端的集成能力。
  • 配置与可观测性：集中化的应用配置、日志、健康检查、内存与知识管理、以及相关工具的自检与状态查询。

• 安装与运行

  • 依赖与环境：需要 Python 环境，安装依赖后可运行 MCP 服务器与辅助组件。服务器提供 UnifiedMCPServer，对应 STDIO/HTTP 模式的启动入口。
  • 运行入口要点：
    • STDIO 模式（Claude Desktop 集成等场景）：运行统一入口脚本，例如 unified_mcp_server.py --mode stdio
    • HTTP 模式（Web/移动客户端）：运行统一入口脚本，例如 unified_mcp_server.py --mode http --host 0.0.0.0 --port 8000
  • 启动前的注意事项：根据需要配置环境变量（如 MCP_REQUIRE_AUTH、MCP_API_KEY、OPENAI_API_KEY、GOOGLE_API_KEY 等），以及 Embedding/LLM 配置（config/llm_config.json、config/embedding_config.json）。

• MCP 客户端配置（JSON）

  • MCP 客户端需要知道如何连接 MCP 服务器（server name、command、args）。以下为示意性描述，请按实际部署填写，客户端本身并不需要你提供完整实现代码：
  • server name: mojo-assistant
  • command: python
  • args: ["/path/to/MoJoAssistant/unified_mcp_server.py", "--mode", "stdio"] 说明：
  • 该配置用于 Claude Desktop 等客户端在启动时连接 MCP 服务器。服务器端实现会监听 STDIO/HTTP 等接口，客户端通过上述启动参数与 MCP 服务器建立通信。
  • 若开启了 OAuth/认证，请在实际客户端配置中提供相应的认证信息或令牌获取方式，服务端会在需要时校验（若开启 MCP_REQUIRE_AUTH）。
  • 具体的服务器端地址、端口、以及可用的端点信息以实际启动时暴露为准。

• 基本使用方法

  • 启动后，客户端通过 MCP 服务器的接口读取/调用资源、执行工具、获取 Prompt 等能力。
  • 典型流程包括：注册工具、读取资源、执行工具、渲染与获取提示模板、将上下文传递给 LLM 进行对话/推理、以及通过 HTTP/STDIO 接口获取 JSON-RPC 风格的响应。
  • 如需调试，可查看服务器日志、健康信息与各组件状态，结合官方文档逐步对接客户端。

• 其他说明

  • 本实现中包含了 OpenCode Manager、OAuth 2.1、知识管理、嵌入模型切换等扩展特性，能够支持较为复杂的后端场景与多模态对话需求。
  • 如需快速上手，请使用示例启动命令启动统一 MCP 服务器，然后在客户端配置中指向对应的启动命令及参数。