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.