国家数据协议服务器

CountryLayer MCP Server 是一个基于CountryLayer API的模型上下文协议服务器,提供多条件的国家数据查询功能。

  • by Corentin-Robac
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Corentin-Robac/countrylayer-mcp

使用说明

CountryLayer MCP服务器

模型上下文协议(MCP)服务器 CountryLayer API.

特性

  • 获取所有国家:检索所有国家的列表。
  • 以名称搜索:按全名或部分名称查找国家。
  • 按资本搜索:按首都查找国家。
  • 按货币搜索:按货币代码查找国家。
  • 按地区搜索:按地区查找国家(如欧洲、亚洲)。
  • 按区域集团搜索:按集团查找国家(例如欧盟、东盟)。
  • 按调用代码搜索:通过调用代码查找国家。
  • 按字母代码搜索:按ISO 3166-1 alpha-2或alpha-3代码查找国家。

设置

先决条件

  • Node.js(v16或更高版本)
  • CountryLayer API密钥(在 countrylayer.com)

安装

  1. 克隆存储库。
  2. 安装依赖项:
    npm install
    
  3. 创建一个 .env 文件,并添加您的API密钥:
    COUNTRYLAYER_API_KEY=your_api_key_here
    

本地使用

要使用MCP检查器或MCP客户端在本地运行服务器:

npm run dev

或者构建并运行:

npm run build
npm start

部署(Docker/Render/Railway)

此服务器被设计为部署为Docker容器。

在渲染上部署

  1. 创建新 Web服务 渲染。
  2. 连接您的GitHub存储库。
  3. 渲染将自动检测 Dockerfile.
  4. 添加环境变量: COUNTRYLAYER_API_KEY.
  5. 部署。

在铁路上部署

  1. 新建项目->从GitHub部署。
  2. 选择存储库。
  3. 添加变量 COUNTRYLAYER_API_KEY.
  4. 铁路将使用Dockerfile构建。

备注:Vercel无服务器功能包括 未推荐的 因为它们不支持SSE传输所需的长期并发连接。

MCP工具

  • get_all_countries
  • get_country_by_name (参数: name, fullText)
  • get_country_by_capital (参数: capital)
  • get_country_by_currency (参数: currency)
  • get_country_by_region (参数: region)
  • get_country_by_bloc (参数: bloc)
  • get_country_by_calling_code (参数: code)
  • get_country_by_alpha (参数: code)