MCP Server Markup Language (MCPML)
MCP Server Markup Language (MCPML) - A Python framework for building MCP Servers with CLI and OpenAI Agent support.
a5c-ai
README
MCP Server Markup Language (MCPML)
A Python framework for building Model Context Protocol (MCP) servers with CLI and OpenAI Agent support.
Features
- 🚀 MCP Server Framework: Build MCP-compliant servers in Python
- 🔧 CLI Tools: All server capabilities exposed as CLI commands
- 🤖 OpenAI Agent SDK Support: Implement tools as OpenAI agents Or as simple python functions
- 🔄 Agent-to-MCP Integration: Agents can consume MCP services via config
- 🛠️ Extensible Architecture: Easily add custom tools and services
- 🔌 Dynamic Loading: Support for custom agent types and tool implementations from the execution directory
- 📦 Structured Output: Support for structured output using Pydantic models
Installation
pip install git+https://github.com/a5c-ai/mcpml#egg=mcpml
.env
OPENAI_API_KEY=your_openai_api_key
or
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
Usage
mcpml --help
mcpml run
mcpml.yaml is the default config file for the MCPML server.
mcpml run -c https://github.com/a5c-ai/some-mcpml-server
mcpml -c mcpml.yaml tools some-tool run --arg1 value1 --arg2 value2
using 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
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor
Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.
Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.