africa-api-mcp

Africa API MCP 服务

一个 MCP 服务，让 Claude 可以直接访问 Africa API——涵盖所有 54 个非洲国家的全面数据，包括经济指标、市场、贸易、政府、选举和政策。

快速开始

1. 获取 API 密钥

在 africa-api.com 注册，并从控制面板创建 API 密钥。

2. 连接客户端

此服务通过 npx 按需运行——无需安装或托管任何内容。选择你的客户端：

Claude Code（一条命令）：

claude mcp add africa-api -e AFRICA_API_KEY=your-api-key-here -- npx -y africa-api-mcp

Claude Desktop——将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），然后重启：

{
  "mcpServers": {
    "africa-api": {
      "command": "npx",
      "args": ["-y", "africa-api-mcp"],
      "env": { "AFRICA_API_KEY": "your-api-key-here" }
    }
  }
}

Cursor——将与上文相同的 mcpServers 配置块添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（按项目）。

VS Code（Copilot Agent 模式）——一条命令：

code --add-mcp '{"name":"africa-api","command":"npx","args":["-y","africa-api-mcp"],"env":{"AFRICA_API_KEY":"your-api-key-here"}}'

其他 MCP 客户端也可以使用相同的 npx -y africa-api-mcp 命令和 AFRICA_API_KEY 环境变量。该服务也已列入 MCP Registry，名称为 io.github.africa-api/africa-api-mcp。

可以向 Claude 提出哪些问题

连接后，Claude 可以回答以下问题：

• “过去 10 年，尼日利亚与南非的 GDP 分别是多少？”
• “显示东非货币当前的外汇汇率。”
• “肯尼亚的国家元首是谁？他们何时就任？”
• “今年非洲有哪些即将举行的选举？”
• “尼日利亚排名前 5 的出口产品是什么？”
• “显示卢旺达的政策时间线。”
• “按预期寿命对非洲国家进行排名。”
• “尼日利亚证券交易所上市了哪些股票？”
• “比较肯尼亚与坦桑尼亚之间的贸易流。”

可用工具

涵盖 9 个领域的 41 个工具：

领域	工具数	涵盖内容
国家	4	所有 54 个国家的详情、概况和实时动态
指标与数据	4	200 多项指标（GDP、人口、健康、能源、贸易等）、时间序列查询、国家排名
政府	6	国家元首、内阁、任职期限——现任及历史信息
选举	5	选举结果、即将举行的选举、国家概览
市场	8	证券交易所、指数水平、上市证券、价格历史、外汇汇率
贸易	4	双边贸易流、主要贸易伙伴、产品细分
政策	6	法律、法规、政策时间线、生命周期事件
来源与平台	3	数据来源和平台信息——世界银行、IMF、联合国、Ember、中央银行
地理区域	1	大洲／区域／次区域层级

所有工具均为只读（标注为 readOnly + idempotent），并同时返回人类可读文本和供程序化客户端使用的结构化 JSON 输出。

配置

环境变量	必需	默认值	说明
AFRICA_API_KEY	是	—	你的 Africa API bearer token
AFRICA_API_BASE_URL	否	https://api.africa-api.com	本地开发时使用的覆盖地址

开发

git clone https://github.com/africa-api/africa-api-mcp.git
cd africa-api-mcp
npm install
npm run build

# Run directly
AFRICA_API_KEY=your-key node dist/index.js

# Test with MCP inspector
AFRICA_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js

许可证

MIT