simple-mcp-server

What is simple-mcp-server?

simple-mcp-server demonstrates how to build Model Context Protocol (MCP) servers for fetching weather information and stock prices. It includes two agents: weather-agent and stocks-agent. This project is intended for developers learning to create MCP tools.

How to use simple-mcp-server?

Clone the repository, then install dependencies for each agent separately using npm install inside the src/weather-agent and src/stocks-agent directories. Configure the server paths in .vscode/mcp.json and start both MCP servers from VS Code to make their tools available.

Key features of simple-mcp-server

• Weather Agent: Fetches real-time temperature and conditions for a given city.
• Stocks Agent: Provides real-time stock prices for Indian share market symbols.
• Uses Node.js (v16 or higher) and NPM/Yarn.
• Integrates with VS Code via MCP protocol configuration.
• Demonstrates a clear example of creating multiple MCP tools in one project.

Use cases of simple-mcp-server

• Learning how to build MCP servers with real-world tools.
• Quickly fetching weather data for any city through an AI assistant.
• Checking current stock prices of Indian companies during conversations.

FAQ from simple-mcp-server

What runtime does simple-mcp-server require?

It requires Node.js version 16 or higher and either NPM or Yarn.

How do I install and start the agents?

Clone the repo, then run npm install inside both src/weather-agent and src/stocks-agent. Use the .vscode/mcp.json configuration to start the servers from VS Code.

What tools does this server provide?

It provides a weather tool (temperature and conditions for a city) and a stocks tool (real-time prices for Indian market symbols).

Does it support markets outside India?

No, the stocks agent explicitly only covers the Indian share market.

Is there any authentication or external API key needed?

No API keys or authentication are mentioned in the README; it appears to use free/public data sources.