国家MCP

@Pedrohmlara/countries-mcp
0 Stars 20 次浏览 Pedrohmlara 更新于 2026-08-23

一个MCP服务器,它从REST Countries API提供与国家相关的数据,允许用户通过自然语言查询国家信息。

该服务暂未提供标准配置,请参考 README 手动接入

服务介绍

国家 MCP

该项目实现了一个 Model Context Protocol (MCP) 服务器,使用 REST Countries API 提供与国家相关数据。它使用 TypeScript 和 Express 构建,并支持 Docker 以便于部署。

先决条件

  • Node.js(v14 或更高版本)
  • Docker 和 Docker Compose
  • npm 或 yarn 包管理器

安装

  1. 安装依赖项:
npm install
  1. 在根目录中添加一个 .env 文件,如 .example 所示

运行应用程序

开发模式

npm run dev

生产模式

  1. 构建应用程序:
npm run build
  1. 启动服务器:
npm start

使用 Docker

  1. 使用 Docker Compose 构建和运行:
docker-compose up --build

API 文档

端点

POST /mcp

用于 MCP 通信的主要端点。

头部:

  • Accept: application/json, text/event-stream
  • mcp-session-id: 会话标识符(新会话为 null)

初始请求:

  • 第一次请求不应包含会话 ID
  • 服务器将在 mcp-session-id 头部响应一个新的会话 ID

后续请求:

  • 包含从初始请求中收到的会话 ID
  • 维护会话上下文以继续交互