Mcplite

🚀 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 驅動）和具體的服務器端函數。它提供了一種標準化的方式來讓開發者暴露功能，並通過客戶端庫可靠地發現和調用這些功能。