MCP Servers Collection 91h

🚀 MCP Server Collection

This repository contains a set of Model Context Protocol (MCP) servers that demonstrate various features and use cases of the MCP ecosystem. Each server implements a specific tool and can be used via an MCP client.

🚀 Quick Start

To use any of these servers:

1. Navigate to the server directory.
2. Install the dependencies using npm install.
3. If building is required (for TypeScript-based servers), run npm run build.
4. Start the server using npm start.

✨ Features

mcp-calculator-server

A basic calculator server that provides arithmetic operations through an MCP tool:

• Features: Basic arithmetic operations (addition, subtraction, multiplication, division).
• Dependencies: @modelcontextprotocol/sdk, zod.
• Usage: cd mcp-calculator-server && npm start.

mcp-calculator-sse-server

An enhanced version of the calculator server that uses Server-Sent Events (SSE) for real-time communication:

• Features: The same arithmetic functions as the basic calculator, but with support for streaming responses.
• Dependencies: @modelcontextprotocol/sdk, express, cors, zod.
• Usage: cd mcp-calculator-sse-server && npm start.

mcp-weather-server

A server that provides weather information:

• Features: Weather data retrieval functionality.
• Dependencies: @modelcontextprotocol/sdk.
• Build: cd mcp-weather-server && npm run build.
• Usage: As a command-line tool: weather.

mcp-file-manager-server

A comprehensive file management server that provides various file system operations:

• Features:
  • List directories.
  • Read and write files.
  • Delete files.
  • Move/rename files.
  • Get file metadata.
  • Search for files using glob patterns.
• Dependencies: @modelcontextprotocol/sdk, glob, zod.
• Build: cd mcp-file-manager-server && npm run build.
• Usage: cd mcp-file-manager-server && npm start.

📚 Documentation

Common Patterns

All these servers:

1. Use the MCP SDK (@modelcontextprotocol/sdk).
2. Implement one or more tools that follow the MCP specification.
3. Use Zod for input validation.
4. Provide specific functions accessible through a standard interface.

Integration with MCP Clients

These servers can be used with any MCP-compatible client, including:

• AI agents implementing the MCP protocol.
• Web applications using MCP to access external tools.
• Command-line interfaces supporting MCP.

Contribution

To add a new MCP server to this collection:

1. Create a new directory following the mcp-{function}-server pattern.
2. Implement the server using the MCP SDK.
3. Include appropriate documentation.
4. Update the information about the new server in this README.

📄 License

MIT