Msty Admin MCP 服务器实现

关键词

本地 AI 服务工具注册知识堆栈模型路由可扩展性

使用说明（Markdown格式）

项目简介

  • 该仓库实现了一个完整的 MCP 服务器，核心功能包括托管资源（Resources）、注册与执行 Tools、定义并渲染 Prompt 模板（Prompts），并通过 MCP 协议与客户端进行 JSON-RPC 交互。服务器还集成了大量扩展模块（Knowledge Stacks、Model 管理、桥接、Turnstile 工作流、Live Context、分析等），实现了从资源管理、工具执行到对话上下文的全面能力，适用于与 Claude Desktop 等 LLM 客户端协同工作。

主要功能点

  • MCP 核心能力

    • 处理 MCP 请求/响应：通过装饰器 @mcp.tool() 将方法暴露为可通过 MCP 客户端调用的工具。
    • 资源、工具、提示模板的管理与渲染：提供读取数据库、查询工具、导出/导入配置、提示模板执行等能力。
    • 会话与状态管理：提供服务器状态、健康检查、资源与工具能力声明等。
    • 安全与可扩展性：含对数据库操作的注入防护、插件化扩展机制、环境变量配置、端口与服务检测等。

  • 可扩展性与插件

    • 服务器内置大量扩展（Phases 10-15、16-25、26-35）的工具，并通过 register_extension_tools、register_extension_tools_v2、register_extension_tools_v3 等函数将其注册到 MCP 服务中，支持知识堆栈、模型管理、智能路由、代理、对话分析、成本分析、 personas/聚合等多模块能力。

  • 部署与运行

    • 服务器核心使用 mcp.server.fastmcp.FastMCP，定义并导出工具，提供启动入口 main()，便于在本地集成 Claude Desktop 等客户端。
    • 代码结构清晰，包含大量依赖的子模块与测试用例，具备可运行性（在合适的环境中可启动并与 Claude Desktop 对接）。

安装与运行要点

  • 先获取依赖环境（Python 3.10+，必要的系统依赖）。
  • 启动 MCP 服务器后，Claude Desktop 需通过配置文件指向该服务器启动命令。
  • 服务端提供多种工具支持，Claude Desktop 可以通过 MCP 请求读取资源、调用工具、获取 Prompt 等。

服务器配置示例（供 MCP 客户端使用的 JSON 配置）

  • 服务器名称：msty-admin
  • 启动命令：/absolute/path/to/msty-admin-mcp/run_msty_server.sh
  • 参数（若有，示例留空）：[]
  • 环境变量示例：{"MSTY_TIMEOUT":"30"}

{ "server": "msty-admin", "command": "/absolute/path/to/msty-admin-mcp/run_msty_server.sh", "args": [], "env": { "MSTY_TIMEOUT": "30" } }

基本使用方法

  • 安装与启动
    • 克隆仓库后，在项目根目录创建并激活虚拟环境，安装依赖，然后使用提供的 launcher 脚本启动 MCP 服务器。
  • 与 Claude Desktop 的对接
    • 在 Claude Desktop 的 MCP 配置中添加一个 MCP 服务器条目，名称为 msty-admin，指向 run_msty_server.sh 的绝对路径。
    • 启动 Claude Desktop，并在工具列表中看到加载的工具（如 113 个工具等，具体数量以实际环境为准）。
  • 运行与调试
    • 通过 Claude Desktop 直接调用 MCP 服务器暴露的工具，服务器返回标准的 JSON-RPC 风格响应。
    • 如需排错，可查看服务器日志、环境变量设置以及 Claude Desktop 的配置路径。

注意事项

  • 服务器对数据库、模型服务等外部依赖具有多处检测，请确保本地环境已启动 Local AI 服务、MLX、LLaMA.cpp 等服务并且端口可访问。
  • 环境变量 MSTY_TIMEOUT 等可通过配置影响超时行为，具体值请按实际网络/响应要求设置。
  • MCP 客户端的配置不需要实现服务器端的具体工具逻辑，只需正确指向启动命令和参数即可。

关键词 资源管理, 模型工具, 实时上下文, 数据分析, 扩展插件

分类ID 6

服务器信息

访问项目