Fist Maestro MCP Servers

🚀 MCP 服务器项目

MCP（Model Context Protocol）服务器项目旨在支持 Cursor IDE 的智能功能，提供多种服务以增强开发体验。当前包含示例服务和天气服务这两个主要服务。

🚀 快速开始

克隆项目

git clone <repository-url>
cd mcp-servers

安装依赖

npm install

构建项目

• 构建所有服务：

npm run build

• 单独构建某个服务（例如天气服务）：

npm run build:weather

配置 MCP

编辑 ~/.cursor/mcp.json 文件，添加如下内容：

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "/your/path/to/mcp-servers/build/weather/index.js"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

启动服务

• 启动天气服务：

npm run start:weather

• 启动示例服务：

npm run start:demo

✨ 主要特性

MCP 服务器项目当前提供了两个主要服务，分别是示例服务和天气服务，具体特性如下：

示例服务（Demo）

• 位置：src/demo/
• 功能：展示 MCP 服务的基本结构和开发方法。
• 特点：
  • 简单的请求响应示例
  • 基础错误处理
  • 完整的代码注释，适合学习

天气服务（Weather）

• 位置：src/weather/
• 功能：提供全球天气查询服务。
• 特点：
  • 实时天气信息查询
  • 提供未来五天的天气预报
  • 支持多个城市同时查询
  • 详细的天气数据

📦 安装指南

开发环境要求

• Node.js 版本 16.0 或更高
• npm 版本 8.0 或更高
• TypeScript 版本 4.5 或更高
• 最新版本的 Cursor IDE

📚 详细文档

项目结构

• src：包含所有服务的源代码。
  • demo：示例服务，展示 MCP 服务的基本结构和开发方法。
  • weather：天气服务，提供实时天气查询功能。
• build：用于存放构建生成的文件。
• node_modules：项目依赖管理目录。

开发指南

创建新服务

1. 在 src 目录下创建新的服务目录（例如 new-service）。
2. 拷贝现有服务（如 demo 或 weather）的结构，并根据需求进行调整。
3. 实现必要的控制器和服务逻辑。
4. 在项目根目录的 package.json 中添加相应的构建和启动脚本。

调试方法

1. 使用 console.error() 输出调试信息。
2. 查看 Cursor IDE 的 MCP 日志窗口。
3. 利用 TypeScript 的源码映射功能进行调试。

测试指南

• 运行所有测试：

npm test

• 单独运行某个服务的测试（例如天气服务）：

npm test weather

常见问题解答

服务无法启动

• 检查是否有端口被占用。
• 确保环境变量已正确配置。

API 调用失败

• 确认 API 密钥是否有效。
• 检查网络连接状态。

Cursor IDE 未识别服务

• 确保 MCP 配置文件 mcp.json 正确无误。
• 重启 Cursor IDE 并重新加载项目。

贡献指南

1. Fork 该项目到你的 GitHub 账户。
2. 创建一个新的分支用于开发新功能或修复问题：

git checkout -b feature/new-service

3. 提交代码并推送到远程仓库：

git push origin feature/new-service

4. 提交 Pull Request 到主分支。

联系方式

如需进一步帮助或反馈问题，请联系项目维护者：

• 邮件：contact@example.com
• GitHub：你的GitHub链接

感谢您对 MCP 服务器项目的关注与支持！