🚀 MCPlite

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

🚀 快速开始

构建服务器

1. 核心流程：
   • 定义服务器端功能。
   • 使用 MCPlite 框架将功能注册为可调用服务。
2. 代码示例：

# 导入 MCPlite 的 Server 类
from mcplite import Server

# 定义自定义服务器类，继承自 Server 类
class MyServer(Server):
    # 定义一个加法函数，接收两个整数参数并返回它们的和
    def add(self, a: int, b: int) -> int:
        return a + b

# 创建自定义服务器类的实例
server = MyServer()
# 启动服务器
server.run()

客户端交互

1. 功能发现： 客户端可以请求服务器获取所有可用功能的列表。示例响应如下：

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

2. 参数设置：

# 创建 MCPlite 客户端实例，连接到本地服务器的 8000 端口
client = MCPliteClient("http://localhost:8000")
# 调用服务器上的 add 函数，传入参数 a 和 b
result = client.call_function("add", a=5, b=3)
# 打印调用结果
print(result)  # 输出: 8

✨ 主要特性

• 功能暴露便捷：开发者能够轻松定义并暴露服务器端功能，供主机应用程序中的 AI 代理程序编程调用。
• 标准化调用：提供标准化方式让开发者暴露功能，通过客户端库可靠地发现和调用这些功能。
• 多数据类型支持：支持多种数据类型，如整数、字符串和自定义对象。

📚 详细文档

传输方式

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

运行中的 MCPlite 服务器

• 功能注册：
  • 每个函数在服务器上都有唯一的标识符。
  • 支持多种数据类型，如整数、字符串和自定义对象。
• 客户端通信：
  • 客户端库通过 JSON 请求格式与服务器交互。示例请求如下：

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

框架结构

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

    风格 MCPF 填充颜色:#ccf, 边框颜色:#333, 边框宽度:2px, 文本颜色:#333
    风格 SP 填充颜色:#e7cfff, 边框颜色:#333, 边框宽度:2px, 文本颜色:#333
    风格 T 填充颜色:#f9f, 边框颜色:#333, 边框宽度:1px, 文本颜色:#333
    风格 A 填充颜色:#ddd, 边框颜色:#333, 边框宽度:1px, 文本颜色:#333
    风格 C 填充颜色:#ddd, 边框颜色:#333, 边框宽度:1px, 文本颜色:#333
    风格 Logic 填充颜色:#white, 边框颜色:#333, 边框宽度:1px, 文本颜色:#333

整体目标

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