Mcpml

🚀 MCP 服務器標記語言（MCPML）

MCPML 是一個用於構建 模型上下文協議 (MCP) 服務器的 Python 框架。它不僅支持命令行界面（CLI），還能與 OpenAI Agent 協同工作，為開發者提供了便捷且強大的工具。

🚀 快速開始

MCPML 是一個強大的 Python 框架，可用於構建符合 MCP 標準的服務器。以下是一些基本的使用命令：

mcpml --help

mcpml run

默認使用 mcpml.yaml 作為 MCPML 服務器的配置文件。

mcpml run -c https://github.com/a5c-ai/some-mcpml-server

mcpml -c mcpml.yaml tools some-tool run --arg1 value1 --arg2 value2

使用 uvx 工具：

uvx --from git+https://github.com/a5c-ai/mcpml#egg=mcpml mcpml -c mcpml.yaml tools list
uvx --from git+https://github.com/a5c-ai/mcpml#egg=mcpml mcpmp run --transport=sse

✨ 主要特性

• 🚀 MCP 服務器框架：使用 Python 構建符合 MCP 標準的服務器。
• 🔧 命令行工具：所有服務器功能可通過 CLI 命令訪問（供人類或腳本使用，而非 MCP 客戶端）。
• 🤖 OpenAI Agent SDK 支持：通過工具或簡單的 Python 函數實現 OpenAI 代理。
• 🔄 Agent 到 MCP 集成：代理可通過配置消費 MCP 服務。
• 🛠️ 可擴展架構：輕鬆添加自定義工具和服務。
• 🔌 動態加載支持：從執行目錄中支持自定義代理類型和工具實現。
• 📦 結構化輸出：使用 Pydantic 模型支持結構化輸出。

📦 安裝指南

使用以下命令安裝 MCPML：

pip install git+https://github.com/a5c-ai/mcpml#egg=mcpml

🔧 配置說明

.env 文件配置

你可以選擇使用 OpenAI API 密鑰或 Azure OpenAI 服務進行配置：

OPENAI_API_KEY=your_openai_api_key

或者

AZURE_OPENAI_ENDPOINT=https://your-azure-openai-endpoint.openai.azure.com
AZURE_OPENAI_API_KEY=your_azure_openai_api_key
OPENAI_API_VERSION=api_version

📄 許可證

本項目採用 MIT 許可證。