About MCP Server Example
MCP Server Example is a weather MCP server for real-time information about Brazilian cities. It is structured around domain-driven design, SOLID principles, and dependency injection, with a separation between domain logic and infrastructure.
Key features
- 01Real-time weather for Brazilian cities
- 02Domain-driven design structure
- 03Dependency injection
- 04Separate domain and infrastructure layers
- 05Jest unit tests
Use cases
- 01Check current weather in Brazilian cities
- 02Explore a domain-driven MCP server structure
- 03Run unit tests while developing the server
MCP support
The project is an MCP server for weather information about Brazilian cities and can be configured for use with Claude Desktop.
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 READMEMCP Server Example
A Domain-Driven MCP server that provides real-time weather information for Brazilian cities. Designed with SOLID principles, it leverages dependency injection and separates domain logic from infrastructure services to ensure scalability, maintainability, and testability. Model Context Protocol concept
Installation
Use the package manager npm to install MCP server.
npm install
Unit Tests
Use the JEST to unit tests.
npm run test
Building
To build the application.
npm run build
Running DEV with @modelcontextprotocol/inpector
- Docs infos in link
- Running dev.
npm run start:dev
Simple use with Claude Desktop APP
- Dowloading Claude Desktop APP in link
- Config your MCP server in Claude APP MCP config (file claude_desktop_config.json) more infos.
Contributing
If you've ever wanted to contribute to open source, and a great cause, now is your chance!
See the contributing docs for more information
Contributors ✨
 JP. Nobrega 💬 📖 👀 📢 |
License
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.