# MCP research notes

## What is it?

A: It's effectively just OpenAPI for LLMs._

A: It is sometimes described as "the USB-C port for AI", providing a uniform
way to connect LLMs to resources they can use.

## Specification

The [MCP specification](https://spec.modelcontextprotocol.io).

### Introduction

- MCP: an in-depth introduction
  https://www.speakeasy.com/mcp/mcp-tutorial
  https://news.ycombinator.com/item?id=43972334

### Evolution

> The spec for the MCP transport is changing from SSE to
> [Streamable HTTP](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#streamable-http).
:::{seealso}
- https://github.com/stuzero/pg-mcp-server/issues/13
- https://github.com/modelcontextprotocol/python-sdk/issues/405
:::

## Gallery

- <https://github.com/punkpeye/awesome-mcp-servers>

## Articles

- What we learned when converting complex OpenAPI specs to MCP servers
  https://www.stainless.com/blog/what-we-learned-converting-complex-openapi-specs-to-mcp-servers

## Package registries

- <https://mcp.so/>
- <https://mcphub.tools/>
- <https://smithery.ai/>
- <https://glama.ai/mcp/servers>
- <https://www.mcpserverfinder.com/>
- <https://www.pulsemcp.com/>
- All: [MCP Registry Registry MCP Server](https://github.com/mastra-ai/mastra/blob/4af513ca1a8e94354c788e40e900d49fbf1c9f86/packages/mcp-registry-registry/src/registry/registry.ts)
- https://github.com/chatmcp/mcpso
- https://mcpservers.org/

## Clients

- [Using an MCP client](https://github.com/modelcontextprotocol/servers/tree/main#using-an-mcp-client)
- [Example Clients](https://modelcontextprotocol.io/clients)
- https://github.com/crate/crate-clients-tools/issues/247

## Servers

- [MCP example servers](https://modelcontextprotocol.io/examples)

### Frameworks

- https://github.com/modelcontextprotocol/python-sdk
- https://github.com/tadata-org/fastapi_mcp
- https://github.com/logiscape/mcp-sdk-php

### Databases

- [PostgreSQL](https://github.com/modelcontextprotocol/servers/blob/main/src/postgres) - Read-only database access with schema inspection, see [@modelcontextprotocol/server-postgres](https://www.npmjs.com/package/@modelcontextprotocol/server-postgres).
- [DBHub](https://github.com/bytebase/dbhub/) - Universal database MCP server connecting to MySQL, PostgreSQL, SQLite, DuckDB and etc.
- [JDBC](https://github.com/quarkiverse/quarkus-mcp-servers/tree/main/jdbc) - Connect to any JDBC-compatible database and query, insert, update, delete, and more. Supports MySQL, PostgreSQL, Oracle, SQL Server, sqllite and [more](https://github.com/quarkiverse/quarkus-mcp-servers/tree/main/jdbc#supported-jdbc-variants).
- https://github.com/stuzero/pg-mcp ([discuss](https://news.ycombinator.com/item?id=43520953))
- https://github.com/runekaagaard/mcp-alchemy
- https://github.com/OpenLinkSoftware/mcp-sqlalchemy-server
- https://github.com/googleapis/genai-toolbox

### Copilots
- https://github.blog/changelog/2025-05-13-agent-mode-mcp-and-next-edit-suggestions-come-to-github-copilot-in-visual-studio-17-14/#mcp-support
- https://github.com/VikashLoomba/copilot-mcp

### Docs and Knowledge

- https://mcp.so/server/mcp-documentation-server/mahawi1992
- https://mcp.so/server/mcp-documentation-server/DotNaos
- Mastra MCP Documentation Server
  - https://mastra.ai/blog/introducing-mastra-mcp
  - https://github.com/mastra-ai/mastra/tree/main/packages/mcp-docs-server
- https://github.com/sammcj/mcp-package-docs
- https://github.com/SubaashNair/documentation-mcp-server
- https://mintlify.com/blog/generate-mcp-servers-for-your-docs
- https://mintlify.com/blog/simplifying-docs-with-llms-txt
- https://llmstxt.org/
- https://github.com/mrjoshuak/godoc-mcp
- https://github.com/jonathanfischer97/juliadoc-mcp
- https://github.com/dazeb/markdown-downloader

### Others

- https://github.com/jjsantos01/qgis_mcp
- https://github.com/ahujasid/blender-mcp
- https://github.com/Simon-Kansara/ableton-live-mcp-server
- https://github.com/ihrpr/mcp-server-jupyter
- https://github.com/fusedio/fused-mcp
- https://pypi.org/project/mcp-atlassian/
- https://pypi.org/project/mcp-server-fetch/
- https://mcp.so/server/mcp-installer
- [pypi-search](https://github.com/nomicode/cline/tree/main/MCP/pypi-search)
- https://github.com/nerding-io/n8n-nodes-mcp
- https://github.com/opensumi/core
- https://github.com/awslabs/mcp
- https://github.com/Upsonic/Upsonic
- https://github.com/anaisbetts/mcp-installer
- https://github.com/mark3labs/mcp-go
- https://github.com/modelcontextprotocol/inspector
- https://github.com/lastmile-ai/mcp-agent
  > [mcp-agent](https://github.com/lastmile-ai/mcp-agent) is a simple, composable framework to build
  > agents using [Model Context Protocol](https://modelcontextprotocol.io/introduction).
  > This one also looks interesting, including [something about marimo](https://github.com/lastmile-ai/mcp-agent#marimo).
- https://github.com/drillan/sphinx-mcp-test
- https://github.com/github/github-mcp-server
- https://github.com/varunneal/spotify-mcp
- https://github.com/BrowserMCP/mcp
- https://github.com/TuanKiri/weather-mcp-server
- https://github.com/mkummer225/google-sheets-mcp
- https://github.com/LaurieWired/GhidraMCP ([discuss](https://news.ycombinator.com/item?id=43474490))
- https://github.com/microsoft/playwright-mcp ([discuss](https://news.ycombinator.com/item?id=43485740))
- https://openai.github.io/openai-agents-python/mcp/ ([discuss](https://news.ycombinator.com/item?id=43485566))
- https://github.com/janwilmake/openapi-mcp-server
- https://gitmcp.io/
- https://github.com/heltonteixeira/ragdocs
- https://github.com/microsoft/semanticworkbench/tree/main/mcp-servers
- https://github.com/JetBrains/mcp-jetbrains

## Composition
- https://github.com/themanojdesai/python-a2a
- https://github.com/Klavis-AI/klavis
- https://github.com/activepieces/activepieces
- https://github.com/mannaandpoem/OpenManus
- https://github.com/OpenManus/OpenManus-RL
- https://github.com/All-Hands-AI/OpenHands