Simple MCP Server

What is Simple MCP Server?

Simple MCP Server is a minimal example project that demonstrates how to build an MCP server. It integrates weather queries via the AMap (Gaode) Open Platform API and sends group messages via DingTalk bots. It is intended for developers learning to build MCP servers or integrating AI chat clients with external services.

How to use Simple MCP Server?

Clone the repository, install dependencies with pnpm i, and build with pnpm build. In an MCP client such as Cherry Studio, add an STDIO MCP server using node as the command and the path to build/index.js as the argument. Set the environment variables GAODE_API_KEY (32‑character AMap API key) and DINGTALK_ACCESS_TOKEN (64‑character DingTalk webhook token). After configuration, open a new conversation, enable the MCP server, and use a large model that supports function calling to trigger the tools.

Key features of Simple MCP Server

• Weather queries: current conditions and forecasts from the AMap API.
• Send messages to DingTalk groups via a custom robot.
• Works with any MCP‑compatible AI chat client.
• Minimal, easy‑to‑follow code for learning MCP server patterns.
• Integrates external API calls triggered by AI model decisions.

Use cases of Simple MCP Server

• A user asks “Do I need to wear a cotton coat in Xi’an today?”; the AI automatically calls the weather tool and returns the answer.
• After querying weather, the result is forwarded to a DingTalk group for team notifications.
• Demonstrates the complete flow: user request → AI intent detection → MCP tool call → external API → response summarization.

FAQ from Simple MCP Server

What dependencies are required?

Node.js 22+, pnpm, an AMap Open Platform Web API key, and a DingTalk custom robot webhook token.

Which MCP clients are supported?

Any AI chat client that supports the MCP protocol, such as Cline, Continue, Claude Desktop, and Cherry Studio.

What large model should I use?

Choose a model with function‑calling capability (marked with a 🔧 icon in Cherry Studio), for example Qwen2.5‑7B‑Instruct from SiliconFlow.

Where does the weather data come from?

Weather data is fetched in real time from the AMap (Gaode) Open Platform weather query API.

What transport does Simple MCP Server use?

It uses STDIO transport between the MCP client and the server. Authentication is handled via environment variables for the API keys.