About simple-mcp-server
simple-mcp-server demonstrates MCP servers that retrieve weather information for a city and stock prices for symbols in the Indian share market. It is intended for developers exploring how to build and run simple MCP servers.
Key features
- 01City weather lookup
- 02Indian market stock prices
- 03Separate weather and stocks agents
- 04VS Code MCP configuration
Use cases
- 01Check a city's temperature and conditions
- 02Look up an Indian-market stock price
- 03Try MCP tools in VS Code
MCP support
It contains two MCP servers, for weather and stock data, whose tools can be started and tested from VS Code using `.vscode/mcp.json`.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEsimple-mcp-server
This project demonstrates how to build simple MCP (Model Context Protocol) servers for fetching weather information and stock prices. It includes two agents: weather-agent and stocks-agent.
Features
- Weather Agent: Fetches real-time weather information (temperature and conditions) for a given city.
- Stocks Agent: Provides real-time stock prices for various symbols in the Indian share market.
Prerequisites
- Node.js (v16 or higher)
- NPM or Yarn
Installation
-
Clone the repository:
git clone <repository-url> cd simple-mcp-server -
Install dependencies for each agent:
cd src/weather-agent npm install cd ../stocks-agent npm install
Adding MCP Servers to VS Code
The .vscode/mcp.json file contains the configuration for running the servers using the MCP protocol. Ensure the paths to the index.js files are correct.
Starting MCP Servers
From .vscode/mcp.json start both MCP servers. You will observe tools from both servers are listed now in VS Code MCP Server.
Testing MCP Servers
Now you can ask questions related to weather or stocks.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.
