MCP Servers Collection

What is MCP Servers Collection?

MCP Servers Collection runs multiple MCP servers using Supergateway to expose each server over SSE (Server-Sent Events). Each server runs in its own container on a dedicated port, providing a bundled set of tools for AI assistants.

How to use MCP Servers Collection?

Clone the repository, copy .env.example to .env, fill in required API tokens (GitHub, Notion, Linear), then run docker-compose up -d. Connect any MCP client (e.g., Claude Desktop, Zed) to the SSE endpoint of an individual server at http://localhost:<PORT>/sse.

Key features of MCP Servers Collection

• Eight pre-configured MCP servers in Docker containers
• Each server exposed via SSE on a unique port (9001–9009)
• GitHub repository and issue management
• Linear issue tracking with GitHub integration
• Notion workspace database and page operations
• Filesystem read/write operations on mounted volume
• Persistent key-value memory across sessions
• Sequential thinking for step-by-step reasoning

Use cases of MCP Servers Collection

• Manage GitHub issues, pull requests, and repository files via AI
• Track Linear project tasks linked to GitHub commits
• Query and update Notion databases programmatically
• Perform file operations on a shared workspace directory
• Maintain context across conversation sessions with persistent memory
• Retrieve up-to-date documentation to avoid hallucinated APIs

FAQ from MCP Servers Collection

What transport protocol do the servers use?

Each server is exposed over Server-Sent Events (SSE) via Supergateway. The SSE endpoint is at http://localhost:<PORT>/sse and POST messages go to http://localhost:<PORT>/message.

What dependencies are required to run this collection?

Docker and Docker Compose are required. Individual servers may need API tokens (GitHub, Notion, Linear) set in the .env file.

How do I connect a client to a specific server?

Configure your client (e.g., Claude Desktop) to use Supergateway as a stdio-to-SSE bridge. Example: npx -y supergateway --sse http://localhost:9001/sse for the GitHub server.

How do I add a new MCP server to the collection?

Add a service to docker-compose.yml, choose the next available port (9007+), add any needed environment variables to .env.example, and update the README with the server details.

How can I troubleshoot connectivity issues?

Check container status with docker-compose ps, view logs with docker-compose logs -f <service>, and test the SSE endpoint with curl http://localhost:<PORT>/sse.