Simple MCP Server

What is Simple MCP Server?

Simple MCP Server is an example project that demonstrates how to build an MCP (Model Context Protocol) server in a minimal way. It integrates with the Amap (Gaode) weather API to provide real-time and forecast weather data. This server is intended for developers who want to learn MCP server implementation or need a basic weather‑query AI tool.

How to use Simple MCP Server?

Build the server jar with ./mvnw clean install -DskipTests (requires Java 17+ and Maven 3.6+). Then configure an MCP‑capable client (e.g., Cherry Studio) with STDIO transport, pointing to the built jar. Set the environment variable GAODE_API_KEY with your Amap Web API key (32‑character key). In the client, select a large language model that supports Function Call (marked with a 🔧 icon in Cherry Studio), enable the MCP server, and then ask weather‑related questions.

Key features of Simple MCP Server

• Weather query: real‑time and forecast weather via the Amap API.
• STDIO transport mode for easy client integration.
• Designed for AI assistants with Function Call capability.
• Built with Spring Boot and Spring AI concepts.
• Example code for building custom MCP servers.

Use cases of Simple MCP Server

• An AI assistant answering “Do I need a coat today?” for a given city.
• Demonstrating MCP server creation for educational purposes.
• Prototyping weather‑aware chatbots or tools.

FAQ from Simple MCP Server

What environment is needed to run Simple MCP Server?

Java 17 or later, Maven 3.6 or later, and understanding of Spring Boot/Spring AI concepts are required. An MCP client (e.g., Cherry Studio, Cline, Claude Desktop) is also needed.

How do I get the Amap API key?

Register an account at the Amap Open Platform console, apply for a Web API key, and set it as the GAODE_API_KEY environment variable.

What kind of large language model does the client need?

The client must use a model that supports Function Call (marked with a 🔧 icon in Cherry Studio, e.g., Qwen2.5-7B-Instruct provided by SiliconFlow).

What transport mode does this MCP server use?

It uses STDIO transport mode and is typically started automatically by the client.

How do I build the server jar?

Run ./mvnw clean install -DskipTests from the project root. The resulting jar is located at target/mcp-weather-stdio-server-0.0.1-SNAPSHOT.jar.