aiohttp-mcp
About
Tools for building Model Context Protocol (MCP) servers on top of aiohttp
Details
- Author
- kulapard
- GitHub stars
- 8
- Downloads
- 220
- Categories
- Other
Jump to
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
aiohttp-mcpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via uv add aiohttp-mcp or pip install aiohttp-mcp. Then create an AiohttpMCP instance, define tools using the @mcp.tool() decorator, and build the application with `build_mcp_app
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"aiohttp-mcp": {
"aiohttp-mcp": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"aiohttp-mcp": {
"command": "uv",
"args": [
"venv"
]
}
}aiohttp-mcp
---
Tools for building Model Context Protocol (MCP) servers on top of aiohttp.
Implements the MCP protocol natively — no heavy SDK dependencies. Only 3 runtime dependencies: aiohttp, aiohttp-sse, pydantic.
Features
- Native MCP protocol implementation (supports specs 2025-11-25, 2025-06-18, 2025-03-26)
- Streamable HTTP transport with SSE streaming
- Easy integration with aiohttp web applications
- Tool, Resource, and Prompt support with decorator-based registration
- Shared state via ctx.app and per-request data via ctx.request
- Stateless by default, with optional stateful mode for server push and resumability
- Event store support for resumability
- Async-first design with full type hints
- JSON response mode for non-streaming deployments
Installation
With uv package manager:
uv add aiohttp-mcp
Or with pip:
pip install aiohttp-mcp
Quick Start
Basic Server Setup
Create a simple MCP server with a custom tool:
```python
import datetime
from zoneinfo import ZoneInfo
from aiohttp import web
from aiohttp_mcp import AiohttpMCP, build_mcp_app
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
