Countries MCP
This project implements a Model Context Protocol (MCP) server that provides country-related data using the REST Countries API. It's built using TypeScript and Express, with Docker support for easy deployment.
Prerequisites
- Node.js (v14 or higher)
- Docker and Docker Compose
- npm or yarn package manager
Installation
- Install dependencies:
- Add a
.env
file in the root directory as .example shows
Running the Application
Development Mode
Production Mode
- Build the application:
- Start the server:
Using Docker
- Build and run using Docker Compose:
API Documentation
Endpoints
POST /mcp
Main endpoint for MCP communication.
Headers:
Accept: application/json, text/event-stream
mcp-session-id
: Session identifier (null for new sessions)
Initial Request:
- First request should not include a session ID
- Server will respond with a new session ID in the
mcp-session-id
header
Subsequent Requests:
- Include the session ID received from the initial request
- Maintains the session context for continued interaction
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An MCP server that provides country-related data from the REST Countries API, allowing users to query information about countries through natural language.
Related MCP Servers
- -security-license-qualityAn MCP server that enables querying detailed address information from Brazilian postal codes (CEPs) via the ViaCEP API, returning data such as street names, neighborhoods, cities, states, regions, and IBGE codes.Last updated -TypeScriptMIT License
RSS3 MCP Serverofficial
-securityAlicense-qualityAn MCP server implementation that integrates the RSS3 API, allowing users to query data from decentralized chains, social media platforms, and the RSS3 network through natural language.Last updated -1JavaScriptMIT License- -securityFlicense-qualityAn MCP server that enables interaction with Datagouv APIs, primarily allowing users to search for up-to-date information about companies registered in France.Last updated -6TypeScript
- -securityFlicense-qualityAn MCP server that connects to Backlog API, providing functionality to search, retrieve, and update issues through natural language commands.Last updated -531JavaScript