MCP Servers

MCP Tool Server

A production-oriented MCP server exposing tools for weather, currency conversion, text statistics, and server introspection, with auto-discovery, rate limiting, and API key auth.

README

MCP Tool Server

A production-oriented MCP (Model Context Protocol) server that exposes tools to AI agents, built on FastMCP + FastAPI, with Docker support.

Built as a learning/portfolio project referencing the architecture of PrefectHQ/fastmcp, extended with several original pieces:

Auto-discovery tool registry — drop a file with a register(mcp) function into app/tools/ and it's picked up automatically. No manual wiring in main.py.
Per-client rate limiting — in-memory token bucket, keyed by API key.
API key auth on the HTTP surface (/tools/* endpoints), independent from the raw MCP protocol endpoint.
Structured logging with per-request IDs and timing.
/health and /metrics endpoints for basic observability.

Tools included

Tool	Description
`get_weather`	Current weather for a lat/lon (Open-Meteo API)
`convert_currency`	Live FX conversion between currencies
`text_stats`	Word/sentence count + estimated reading time for text
`server_info`	Server introspection (uptime, platform, python version)

Running locally

pip install -r requirements.txt
python -m app.main

Server starts on http://localhost:8000.

MCP protocol clients connect to http://localhost:8000/mcp
HTTP clients can call POST /tools/{tool_name}/invoke with header x-api-key: <key>

Running with Docker

docker compose up --build

Adding a new tool

Create app/tools/my_tool.py:

def register(mcp) -> str:
    @mcp.tool()
    def my_tool(x: int) -> int:
        """Doubles a number."""
        return x * 2
    return "my_tool"

That's it — no changes to main.py needed, it's discovered on startup.

Tests

pytest tests/

Environment variables

Variable	Default	Description
`PORT`	8000	Server port
`API_KEYS`	(empty = no auth)	Comma-separated allowed API keys
`RATE_LIMIT_CAPACITY`	20	Max burst requests per client
`RATE_LIMIT_REFILL_PER_SEC`	2	Token refill rate per second
`LOG_LEVEL`	INFO	Logging verbosity

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.

Official

Featured

TypeScript

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.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured