关键词

上下文服务LLM集成API框架OAuth 2.1HTTP SSE

使用说明

项目简介

MCPEngine 是 Model Context Protocol (MCP) 的生产级 HTTP 优先实现，旨在为大型语言模型 (LLM) 提供安全、可扩展的上下文服务框架。它允许开发者以标准化的方式将数据、工具和提示暴露给 LLM 客户端，无需为每个 LLM 进行定制化集成，正如其标榜的 “LLMs 的 REST”。

主要功能点

  • 资源 (Resources) 管理: 托管和管理各种数据资源，并以标准化的方式提供给 LLM 客户端访问，作为 LLM 的上下文信息。
  • 工具 (Tools) 注册与执行: 允许注册外部功能为工具，供 LLM 客户端按需调用，扩展 LLM 的能力边界。
  • Prompt 模板 (Prompts) 定义与渲染: 支持定义可复用的 Prompt 模板，实现可定制的 LLM 交互模式，提升 Prompt 工程效率。
  • 内置 OAuth 鉴权: 集成 OAuth 2.1 协议，支持 Okta、Keycloak、Google SSO 等多种身份提供商，确保服务安全。
  • HTTP 优先设计: 采用 HTTP 和 SSE (Server-Sent Events) 作为主要通信协议，而非仅限于 Stdio，更适应云原生应用场景。
  • Scope-based 授权: 对工具、资源和 Prompt 提供基于 Scope 的细粒度权限控制。
  • LLM Host 无缝桥接: 通过本地代理 MCPProxy，实现与 Claude Desktop 等 LLM Host 的无缝集成。

安装步骤

  1. 确保已安装 Python 和 pip 或 uv。

  2. 使用 pip 或 uv 安装 mcpengine CLI 工具：

    pip install "mcpengine[cli]"
# 或
uv add "mcpengine[cli]"

服务器配置

以下是 Claude Desktop 集成 MCP 服务器的配置示例（JSON 格式），用于配置 MCP 客户端（如 Claude Desktop）连接 MCPEngine 服务器：

{
  "server name": "your_server_name",
  "command": "bash",
  "args": [
    "mcpengine",
    "proxy",
    "http://your-mcp-server-address/sse"
  ]
}
  • 'server name': 用户自定义的 MCP 服务器名称，用于在 Claude Desktop 中标识该服务器连接。
  • 'command': 运行 MCP 代理客户端的命令。通常为 'bash'，用于执行后续的代理命令。
  • 'args': 传递给 'bash' 命令的参数列表，用于启动 MCP 代理客户端：
    • 'mcpengine': 调用 mcpengine CLI 工具。
    • 'proxy': 指定运行 mcpengine 的 proxy 子命令，启动代理模式。
    • 'http://your-mcp-server-address/sse': 你的 MCPEngine 服务器的 SSE 端点地址。请替换 'http://your-mcp-server-address/sse' 为实际部署的 MCPEngine 服务器地址。

基本使用方法

  1. 定义 MCP 服务: 使用 Python 代码，通过 MCPEngine 提供的装饰器 ('@mcp.resource', '@mcp.tool', '@mcp.prompt') 定义资源、工具和 Prompt。
  2. 启动 MCP 服务器: 运行 Python 代码启动 MCPEngine 服务器，对外提供 MCP 服务。
  3. 配置 MCP 客户端: 在 MCP 客户端（例如 Claude Desktop）中，配置 MCP 服务器的连接信息，主要是服务器的启动命令及其参数（如上述服务器配置示例）。
  4. LLM 交互: 配置完成后，LLM 客户端即可通过 MCP 协议与 MCPEngine 服务器通信，利用服务器提供的资源、工具和 Prompt 进行交互。

信息

分类

网页与API

访问项目