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 许可证。