Mcplite

🚀 MCPlite：Python MCP 服务器框架

MCPlite 是一个 Python MCP 服务器框架，与 FastAPI 类似。其核心价值在于，开发者能够轻松定义并对外暴露 服务器端功能（例如工具、函数或资源访问），这些功能可被主机应用程序中的 AI 代理程序以编程方式调用。

✨ 主要特性

系统架构

graph LR
    subgraph "客户端"
        A[代理] -- 使用 --> C[客户端库]
    end

    subgraph "服务端"
        MCPF[MCPlite 框架] -- 使用 --> SP[MCPlite 服务器进程]
        SP -- 监听于 --> T[传输层]
        SP -- 执行 --> Logic[服务器逻辑]
        C -- 发送请求通过 --> T
        T -- 传递请求到 --> SP
        SP -- 将请求路由到 --> Logic
        Logic -- 返回结果 --> SP
        SP -- 通过传输层发送响应 --> T
        T -- 传递响应到 --> C
        C -- 返回结果 --> A
    end

    style MCPF fill:#ccf,stroke:#333,stroke-width:2px,color:#333
    style SP fill:#e7cfff,stroke:#333,stroke-width:2px,color:#333
    style T fill:#f9f,stroke:#333,stroke-width:1px,color:#333
    style A fill:#ddd,stroke:#333,stroke-width:1px,color:#333
    style C fill:#ddd,stroke:#333,stroke-width:1px,color:#333
    style Logic fill:#fff,stroke:#333,stroke-width:1px,color:#333

传输方式

• 核心概念：
  • 服务器端功能：涵盖工具、函数或资源访问，可被代理程序调用。
  • 客户端库：负责与服务器通信，处理请求和响应。

整体目标

MCPlite 框架致力于连接高层次的代理逻辑（可能由大语言模型 LLM 驱动）和具体的服务器端函数。它为开发者提供了一种标准化的方式来暴露功能，并通过客户端库可靠地发现和调用这些功能。

🚀 快速开始

构建服务器

核心流程

1. 定义服务器端功能。
2. 使用 MCPlite 框架将功能注册为可调用服务。

代码示例

from mcplite import Server

class MyServer(Server):
    def add(self, a: int, b: int) -> int:
        return a + b

server = MyServer()
server.run()

运行中的 MCPlite 服务器

功能注册

• 每个函数在服务器上都有唯一的标识符。
• 支持多种数据类型，如整数、字符串和自定义对象。

客户端通信

• 客户端库通过 JSON 请求格式与服务器交互。
• 示例：

{
    "function": "add",
    "parameters": {
        "a": 5,
        "b": 3
    }
}

客户端交互

功能发现

• 客户端可以请求服务器获取所有可用功能的列表。
• 示例响应：

[
    {
        "name": "add",
        "parameters": ["a", "b"],
        "return_type": "int"
    }
]

参数设置

client = MCPliteClient("http://localhost:8000")
result = client.call_function("add", a=5, b=3)
print(result)  # 输出: 8