MCP Servers 项目

基本能力

产品定位

MCP Servers 是一个基于 Model Context Protocol (MCP) 开发的服务集合，主要用于支持 Cursor IDE 的智能功能。

核心功能

1. 示例服务（Demo）：展示 MCP 服务的基本结构和开发方法，包含简单的请求响应示例和基础错误处理。
2. 天气服务（Weather）：提供全球天气查询服务，包括实时天气查询、5天天气预报和多城市查询。

适用场景

1. 开发学习：通过示例服务学习 MCP 服务的基本结构和开发方法。
2. 天气查询：在 Cursor IDE 中集成天气查询功能。

工具列表

1. 示例服务：提供基本的请求响应示例，适合学习和开发。
2. 天气服务：提供全球天气查询功能，支持多城市查询和详细的天气信息。

常见问题解答

1. 服务无法启动：检查端口占用、环境变量配置和构建输出。
2. API 调用失败：检查 API Key 配置、网络连接和错误日志。
3. Cursor IDE 无法识别服务：检查 MCP 配置、重启 Cursor IDE 并确认服务状态。

使用教程

使用依赖

1. Node.js >= 16.0.0
2. npm >= 8.0.0
3. TypeScript >= 4.5.0
4. Cursor IDE（最新版本）

安装教程

1. 克隆项目

git clone <repository-url>
cd mcp-servers

1. 安装依赖

npm install

1. 构建项目

# 构建所有服务
npm run build

# 构建单个服务
npm run build:weather  # 构建天气服务
npm run build:demo    # 构建示例服务

1. 配置 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"
      }
    }
  }
}

1. 启动服务

# 启动天气服务
npm run start:weather

# 启动示例服务
npm run start:demo

调试方式

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

许可证

该项目遵循 None 开源许可条款。