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
- -securityFlicense-qualityAn MCP server providing timezone conversions and time-related operations via RESTful API endpoints, featuring comprehensive error handling and timezone database integration.Last updated -Python
- -securityFlicense-qualityA tutorial MCP server implementation that provides country information, demonstrating the Model Context Protocol for building AI-powered applications with external service integration capabilities.Last updated -
- -securityFlicense-qualityA MCP server that uses Amap API to provide location-based services, allowing users to get geographic information based on IP addresses and search for nearby points of interest.Last updated -9Python
- -securityFlicense-qualityThis MCP server enables interaction with the Open States API, allowing users to access legislative data from US state governments through natural language commands.Last updated -Python