
MCP Servers 项目

2025.04.01
0
TypeScript开发效率开发效率
MCP Servers 是基于 Model Context Protocol (MCP) 开发的服务集合,主要用于支持 Cursor IDE 的智能功能。目前包含示例服务和天气服务。该项目采用三层架构设计,包括配置层、控制器层和服务层,每个服务都遵循相同的结构模式。
View on GitHub
Overview
基本能力
产品定位
MCP Servers 是一个基于 Model Context Protocol (MCP) 的服务集合,旨在支持 Cursor IDE 的智能功能。
核心功能
- 示例服务(Demo):展示 MCP 服务的基本结构和开发方法,包含简单的请求响应示例和基础错误处理。
- 天气服务(Weather):提供全球天气查询服务,包括实时天气查询、5天天气预报和多城市查询。
适用场景
- 开发学习:通过示例服务学习 MCP 服务的基本结构和开发方法。
- 天气查询:通过天气服务获取实时天气信息和天气预报。
工具列表
- 示例服务:提供基础的请求响应示例,适合学习和调试。
- 天气服务:提供全球天气查询功能,支持多城市查询和详细的天气信息。
常见问题解答
- 服务无法启动:检查端口占用、环境变量配置和构建输出。
- API 调用失败:检查 API Key 配置、网络连接和错误日志。
- Cursor IDE 无法识别服务:检查 MCP 配置、重启 Cursor IDE 并确认服务状态。
使用教程
使用依赖
- Node.js >= 16.0.0
- npm >= 8.0.0
- TypeScript >= 4.5.0
- Cursor IDE(最新版本)
安装教程
- 克隆项目
bash git clone <repository-url> cd mcp-servers
- 安装依赖
bash npm install
- 构建项目
bash npm run build
- 配置 MCP
编辑
~/.cursor/mcp.json
文件,添加服务配置。 - 启动服务
bash npm run start:weather npm run start:demo
调试方式
- 使用
console.error()
输出调试信息。 - 检查 Cursor IDE 的 MCP 日志。
- 使用 TypeScript 的源码映射功能。