africa-api-mcp

Africa API MCP Server

Claude が Africa API に直接アクセスできるようにする MCP サーバーです。経済指標、市場、貿易、政府、選挙、政策など、アフリカの54か国すべてを網羅したデータを利用できます。

クイックスタート

1. API キーを取得する

africa-api.com で登録し、ダッシュボードから API キーを作成します。

2. クライアントを接続する

サーバーは npx を使ってオンデマンドで実行されます。インストールもホスティングも不要です。クライアントを選んでください。

Claude Code（コマンド1つ）：

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 — ~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）に、上記と同じ mcpServers ブロックを追加します。

VS Code（Copilot エージェントモード）— コマンド1つ：

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	データの出典とプラットフォーム情報（World Bank、IMF、UN、Ember、中央銀行）
地理区分	1	大陸／地域／小地域の階層

すべてのツールは読み取り専用（readOnly と idempotent の注釈付き）で、人が読めるテキストと、プログラムから利用するクライアント向けの構造化 JSON 出力の両方を返します。

設定

環境変数	必須	デフォルト	説明
AFRICA_API_KEY	はい	—	Africa API のベアラートークン
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