国家MCP
一个MCP服务器,它从REST Countries API提供与国家相关的数据,允许用户通过自然语言查询国家信息。
服务介绍
国家 MCP
该项目实现了一个 Model Context Protocol (MCP) 服务器,使用 REST Countries API 提供与国家相关数据。它使用 TypeScript 和 Express 构建,并支持 Docker 以便于部署。
先决条件
- Node.js(v14 或更高版本)
- Docker 和 Docker Compose
- npm 或 yarn 包管理器
安装
- 安装依赖项:
npm install
- 在根目录中添加一个
.env文件,如 .example 所示
运行应用程序
开发模式
npm run dev
生产模式
- 构建应用程序:
npm run build
- 启动服务器:
npm start
使用 Docker
- 使用 Docker Compose 构建和运行:
docker-compose up --build
API 文档
端点
POST /mcp
用于 MCP 通信的主要端点。
头部:
Accept: application/json, text/event-streammcp-session-id: 会话标识符(新会话为 null)
初始请求:
- 第一次请求不应包含会话 ID
- 服务器将在
mcp-session-id头部响应一个新的会话 ID
后续请求:
- 包含从初始请求中收到的会话 ID
- 维护会话上下文以继续交互