Aiohttp MCP

🚀 AIOHTTP-MCP

A tool for building Model Context Protocol (MCP) servers based on aiohttp.

✨ Features

• Effortless integration with aiohttp Web applications.
• Support for Model Context Protocol (MCP) tools.
• Asynchronous-first design.
• Type hint support.
• Debugging functionality in development mode.
• Flexible routing options.

📦 Installation

Use the uv package manager:

uv add aiohttp-mcp

Or use pip:

pip install aiohttp-mcp

🚀 Quick Start

Basic Server Setup

Create a simple MCP server and custom tools:

import datetime
from zoneinfo import ZoneInfo

from aiohttp import web

from aiohttp_mcp import mcp

# Initialize the MCP instance
mcp_instance = mcp.MCP()

# Define the route handler
async def handler(request):
    # Handle the request logic
    pass

# Create the Web application
app = web.Application()
app.add_routes([web.get('/', handler)])

# Run the application
if __name__ == '__main__':
    web.run_app(app)

Sub-application Configuration

Integrate MCP into an existing aiohttp application:

import datetime
from zoneinfo import ZoneInfo

from aiohttp import web

from aiohttp_mcp import mcp

# Initialize the MCP instance
mcp_instance = mcp.MCP()

# Create a sub-application
sub_app = web.Application()
sub_app.add_routes([web.get('/sub', handler)])

# Create the main application and register the sub-application with the route prefix '/sub'
main_app = web.Application()
main_app.add_subapp('/sub', sub_app)

# Run the application
if __name__ == '__main__':
    web.run_app(main_app)

📚 Documentation

Environment Setup

1. Install the dependencies:

pip install aiohttp aiohttp-sse anyio mcp

2. Clone the repository:

git clone https://github.com/kulapard/aiohttp-mcp.git
cd aiohttp-mcp

Code Development

• Follow PEP8 and the Python Type Hints Guide.
• Run the tests before committing:

pytest tests/

Code Submission

• Format the code using black:

black .

• Check the type hints:

mypy .

🔧 Technical Details

• Python 3.10 or higher.
• aiohttp >= 3.9.0, < 4.0.0.
• aiohttp-sse >= 2.2.0, < 3.0.0.
• anyio >= 4.9.0, < 5.0.0.
• mcp >= 1.6.0, < 2.0.0.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💪 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.