使用说明

项目简介

Eunomia MCP Server 是一个基于 Model Context Protocol (MCP) 的开源应用后端,旨在为 LLM (大型语言模型) 应用提供强大的上下文服务能力。它不仅实现了 MCP 服务器的核心功能,还集成了 Eunomia 框架的数据治理能力,可以作为 MCP 生态系统中的中心服务器,连接和管理多个其他的 MCP 服务器。

主要功能点

  • MCP 服务器: 完全实现了 Model Context Protocol 协议,可以接收和处理来自 MCP 客户端的请求,例如工具调用、Prompt 获取和资源访问等。
  • 多服务器编排: 能够配置和连接多个下联的 MCP 服务器,并将这些服务器的功能整合到一个统一的接口中,简化客户端的调用流程。
  • 数据治理: 集成了 Eunomia 框架,可以对所有经过服务器的数据流应用预定义的数据治理策略,例如自动检测和编辑个人身份信息 (PII),确保数据安全和合规性。
  • 工具、Prompt 和资源聚合: 统一管理和暴露来自所有下联 MCP 服务器的工具 (Tools)、Prompt 模板 (Prompts) 和资源 (Resources),方便客户端发现和使用。

安装步骤

  1. 克隆仓库
    git clone https://github.com/whataboutyou-ai/eunomia-mcp-server.git
    cd eunomia-mcp-server

服务器配置

MCP 客户端需要配置 MCP 服务器的连接信息,主要是服务器的启动命令。对于 Eunomia MCP Server,你需要配置其启动命令,以便客户端能够正确连接。以下是一个示例配置,你需要根据实际情况修改代码路径:

{
  "serverName": "eunomia-mcp-server",
  "command": "uv",
  "args": [
    "--directory",
    "path/to/eunomia-mcp-server/", // 将 "path/to/eunomia-mcp-server/" 替换为克隆仓库在您本地的实际路径
    "run",
    "orchestra_server"
  ]
}

配置参数说明:

  • 'serverName': MCP 服务器的名称,可以自定义。
  • 'command': 运行 MCP 服务器的命令,这里使用 'uv' (一个快速的 Python 包安装器和运行器)。
  • 'args': 传递给 'uv' 命令的参数列表:
    • '--directory': 指定服务器代码所在的目录,请务必替换为 Eunomia MCP Server 仓库在您本地的实际路径
    • 'run orchestra_server': 运行名为 'orchestra_server' 的 Python 模块,这是 Eunomia MCP Server 的入口点。

基本使用方法

  1. 配置下联 MCP 服务器: 编辑 'src/orchestra_server/config.py' 文件,修改 'MCP_SERVERS' 字典,添加或修改需要 Eunomia MCP Server 连接和管理的下联 MCP 服务器的配置。例如,要添加一个名为 'web-browser-mcp-server' 的服务器,可以进行如下配置:

    MCP_SERVERS: dict = {
        "web-browser-mcp-server": {
            "command": "uv",
            "args": ["tool", "run", "web-browser-mcp-server"],
            "env": {"REQUEST_TIMEOUT": "30"},
        }
    }

    这里的 'command' 和 'args' 是启动 'web-browser-mcp-server' 的命令,你需要根据实际下联服务器的启动方式进行配置。

  2. 运行 Eunomia MCP Server: 在克隆的仓库根目录下,打开终端并执行以下命令启动服务器 (同样需要替换路径为实际路径):

    uv --directory "path/to/eunomia-mcp-server/" run orchestra_server
  3. 配置 MCP 客户端: 在你的 MCP 客户端应用中,配置连接到 Eunomia MCP Server。客户端需要使用与 Eunomia MCP Server 兼容的 MCP 传输协议 (如 Stdio) 与服务器建立连接,并按照 MCP 协议规范发送请求和接收响应。客户端发送的请求将通过 Eunomia MCP Server 路由到相应的下联服务器,并经过数据治理策略的处理。

注意: Eunomia MCP Server 本身作为一个 MCP 服务器,主要用于编排和管理 其他 MCP 服务器。你需要同时运行至少一个下联的 MCP 服务器,并在 Eunomia MCP Server 的配置中正确配置下联服务器的启动信息,才能体验其完整功能。

信息

分类

AI与计算