MCP Servers 项目

What is MCP Servers 项目?

MCP Servers 项目 is a collection of services built on the Model Context Protocol (MCP) to enhance Cursor IDE with intelligent features. Currently it includes a demo service for learning and a weather service for live weather data. It is aimed at developers using Cursor IDE who want to extend its capabilities with custom MCP tools.

How to use MCP Servers 项目?

Clone the repository, install dependencies with npm install, build all services with npm run build or individual services using npm run build:weather. Configure MCP in ~/.cursor/mcp.json with the appropriate command and environment variables (e.g., OPENWEATHER_API_KEY). Start a service with npm run start:weather or npm run start:demo. The server is invoked via Cursor IDE using the configured MCP tool definitions.

Key features of MCP Servers 项目

• Three-layer architecture: config, controllers, service
• Demo service for learning MCP patterns
• Weather service with real-time and 5‑day forecasts
• Supports multiple city queries
• TypeScript with typed constants and interfaces
• Environment‑based API key management

Use cases of MCP Servers 项目

• Building a live weather assistant inside Cursor IDE
• Learning how to create MCP‑compatible services step‑by‑step
• Integrating external weather APIs through Cursor’s MCP interface
• Extending Cursor IDE with custom tools for development workflows

FAQ from MCP Servers 项目

What runtime dependencies are required?

Node.js >= 16.0.0, npm >= 8.0.0, TypeScript >= 4.5.0, and the latest Cursor IDE are required.

How do I configure the weather service?

Edit ~/.cursor/mcp.json and add a “weather” entry with the command node and an args array pointing to the built build/weather/index.js. Set the OPENWEATHER_API_KEY environment variable.

Why won’t the service start?

Check that the port is not in use, confirm all environment variables are set correctly, and verify that the build output exists (npm run build).

What should I do if Cursor IDE doesn’t recognize the service?

Double‑check the MCP configuration in mcp.json, restart Cursor IDE, and ensure the service is actually running.

How can I add a new service?

Create a new directory under src/ following the existing structure (config, controllers, service), implement the layers, add build and start scripts in package.json, then rebuild and reconfigure MCP.