MCP Servers 项目

MCP Servers 项目

site icon
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 的智能功能。

核心功能

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

适用场景

  1. 开发学习:通过示例服务学习 MCP 服务的基本结构和开发方法。
  2. 天气查询:通过天气服务获取实时天气信息和天气预报。

工具列表

  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. 克隆项目 bash git clone <repository-url> cd mcp-servers
  2. 安装依赖 bash npm install
  3. 构建项目 bash npm run build
  4. 配置 MCP 编辑 ~/.cursor/mcp.json 文件,添加服务配置。
  5. 启动服务 bash npm run start:weather npm run start:demo

调试方式

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

许可证

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