MCP Servers Collection

MCP 服务集合

此仓库包含一组 Model Context Protocol（MCP）服务，展示了 MCP 生态系统的各种功能和用例。每个服务都实现了 MCP 客户端可使用的特定工具。

概述

MCP（Model Context Protocol）为模型访问外部工具和资源提供了一种标准化方式。这些服务实现了该协议，可提供各种服务供兼容 MCP 的客户端使用。

mcp-calculator-server

一个基础计算器服务，通过 MCP 工具提供算术运算：

• 功能：基础算术运算（加、减、乘、除）
• 依赖项：@modelcontextprotocol/sdk、zod
• 用法：cd mcp-calculator-server && npm start

mcp-calculator-sse-server

计算器服务的增强版本，使用服务器发送事件（SSE）进行实时通信：

• 功能：具备与基础计算器相同的算术功能，并支持流式响应
• 依赖项：@modelcontextprotocol/sdk、express、cors、zod
• 用法：cd mcp-calculator-sse-server && npm start

mcp-weather-server

一个通过 MCP 工具提供天气信息的服务：

• 功能：获取天气数据
• 依赖项：@modelcontextprotocol/sdk
• 设置：cd mcp-weather-server && npm run build
• 用法：作为命令行工具使用：weather

mcp-file-manager-server

一个全面的文件管理服务，提供各种文件系统操作：

• 功能：
  • 列出目录
  • 读取和写入文件
  • 删除文件
  • 移动/重命名文件
  • 获取文件元数据
  • 使用 glob 模式搜索文件
• 依赖项：@modelcontextprotocol/sdk、glob、zod
• 设置：cd mcp-file-manager-server && npm run build
• 用法：cd mcp-file-manager-server && npm start

通用模式

此集合中的所有服务：

1. 使用 MCP SDK（@modelcontextprotocol/sdk）
2. 实现一个或多个符合 MCP 规范的工具
3. 使用 Zod 验证输入
4. 通过标准化接口提供特定功能

入门指南

要使用其中任何一个服务：

1. 进入服务目录
2. 使用 npm install 安装依赖项
3. 如有需要，构建服务（基于 TypeScript 的服务）
4. 使用 npm start 启动服务

与 MCP 客户端集成

这些服务可与任何兼容 MCP 的客户端搭配使用，包括：

• 实现 MCP 协议的 AI Agent
• 使用 MCP 访问外部工具的 Web 应用
• 支持 MCP 的命令行界面

贡献

要向此集合添加新的 MCP 服务：

1. 按照 mcp-{functionality}-server 模式创建新目录
2. 使用 MCP SDK 实现服务
3. 添加适当的文档
4. 更新此 README，添加新服务的信息

许可证

MIT