getapi

GetApi MCP Server

GetApi APIを、Claude DesktopなどのAIクライアントから利用できるようにするMCPサーバーです。

インストール

npmでサーバーをインストールします。

npm install -g getapi-mcp

機能

このサーバーは、すべてのGetApi APIエンドポイントをAIクライアント用のツールとして提供します。サーバーはstdio経由で通信し、npx getapi-mcpで起動します。APIキーは環境変数API_KEYでのみ設定します。

必要条件

• Node.js 20 LTS以降
• 有効なGetApi APIキー

設定

CLIの使用方法

npx getapi-mcp

MCPサーバーの設定

クライアントのMCP設定に、以下の設定を追加します（たとえば、Claude Desktopの場合はclaude_desktop_config.json）。

{
  "mcpServers": {
    "getapi": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "API_KEY": "ga_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

重要：APIキーはenv経由でのみ設定します。サーバーはログと出力からキーを完全にマスキングします。

APIキーの取得

GetApiの有効なAPIキーが必要です。キーの作成と管理については、ダッシュボードを参照してください。

注：キーはga_live_xxxxxまたはga_test_xxxxxの形式である必要があります。

利用可能なツール

ツール一覧はGetApiのOpenAPI仕様から自動生成され、1時間ごとに更新されます。

ツールの例

ツール	説明
getapi_kadaster_bag_address	郵便番号と番地から住所を検索（BAG）
getapi_kadaster_bag_address-suggest	住所のオートコンプリート候補
getapi_kadaster_bag_id	住所表示IDから住所を検索
getapi_lookup_postcode	郵便番号の検索（NL）
getapi_lookup_ip	IP／ISP情報
getapi_validation_iban	IBAN／BICの検証
getapi_validation_vat	EUのVAT番号を検証（VIES）
getapi_property_pandgegevens	郵便番号と番地から建物情報を取得
getapi_rdw_vehicle	ナンバープレートから車両情報を取得（RDW）
getapi_lookup_dns_records	ドメインのDNSレコード
...	OpenAPI仕様から全エンドポイントの一覧が生成されます

全エンドポイントの一覧については、GetApi APIドキュメントを参照してください。

使用方法

ツールの呼び出し

1. MCPアイコン（通常はチャット画面内）をクリックします
2. GetApiサーバーをMCPサーバーとして追加します
3. MCPパネルでツールをクリックします
4. 必須パラメーターを入力します
5. ツールが実行され、結果が表示されます

エラーコード

ネットワークエラーが発生すると、具体的なエラーメッセージが表示されます。

コード	説明	解決方法
404	リソースが見つかりません	URLとパラメーターを確認してください
400	パラメーターエラー	パラメーターの構文を確認してください
422	検証エラー	パラメーターの型を確認してください
503	サーバーが一時的に利用できません	後でもう一度お試しください
TIMEOUT	リクエストがタイムアウトしました	タイムアウト時間を延長してください
401	APIキーが無効です	APIキーを確認してください

セキュリティ

• APIキーがログ、出力、ツールの結果に表示されることはありません
• すべてのリクエストはhttps://api.getapi.nlにのみ送信されます
• サーバーはログ内のAPIキーを自動的にマスキングします
• キーがGetApiに送信されることはありません

自動更新

サーバーはGetApi仕様に変更がないか、1時間ごとに確認します。更新がある場合：

• ツール一覧が自動的に更新されます
• クライアントに通知が届きます（クライアントの対応状況によります）
• 無効な仕様は無視され、最後に正常だったバージョンが使用されます

注：自動更新に対応していないMCPクライアントもあります。新しいツールを表示するには、クライアントを再起動してください。

既知の制限事項

1. x402エンドポイント：有料のAIエンドポイントは提供されません（AIクライアントには不要です）
2. クライアントの対応状況：ツール一覧が変更された場合は、クライアントを再起動してください
3. タイムアウト：リクエストのタイムアウトは10秒です
4. レスポンスサイズ：最大1 MBです
5. 仕様のサイズ：OpenAPI仕様の上限は5 MBです

設定オプション

これらの値は現在、サーバーに固定で設定されており、環境変数では変更できません。環境変数として設定できるのは API_KEY のみです。

オプション	デフォルト	説明
specUrl	https://api.getapi.nl/docs/api.json	GetApi OpenAPI 仕様の URL
baseUrl	https://api.getapi.nl	API リクエストのベース URL
authHeader	X-Api-Key	認証用ヘッダー名
refreshIntervalMs	3600000 (1 時間)	仕様を確認する間隔
timeoutMs	10000	リクエストのタイムアウト (ms)
maxResponseSize	1048576	レスポンスの最大サイズ (1 MB)
maxSpecSize	5242880	仕様の最大サイズ (5 MB)
x402ExcludedOperations	空	ツールとしてエクスポートしない Operation-ID

設定例

環境変数は API_KEY のみです。

{
  "mcpServers": {
    "getapi": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "API_KEY": "ga_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

トラブルシューティング

「API_KEY が設定されていないか、無効です」

API_KEY が設定されていない場合、または ga_live_／ga_test_ で始まらない場合、サーバーはこのメッセージを表示して停止します。MCP クライアントの設定で変数を設定してください（「設定」を参照）。

「利用可能な仕様がありません」

• 仕様の URL（https://api.getapi.nl/docs/api.json）にアクセスできません
• GetApi の仕様が一時的に利用できません
• インターネット接続を確認してください

この場合、サーバーは getapi_ping フォールバックツールのみで起動し、次回の更新時に再試行します。

「パラメーターの検証に失敗しました」

• ツールの inputSchema と照らし合わせて、パラメーター名と型を確認してください
• 必須パラメーターは required に記載されています

ステータスコードのエラー（例：401／404）

• 401：API キーが無効、または設定されていません
• 404：パラメーターが間違っているか、エンドポイントが不明です
• 503／504：API が一時的に利用できないか、タイムアウトしました

開発とテスト

# Afhankelijkheden installeren
npm install

# Alles valideren: typecheck + lint + build + tests (unit + e2e)
npm run validate

# Volledige check inclusief smoke-test van het gepackagede npm-artefact
npm run verify

# Alleen de tests
npm test

# Tests met coverage (en coverage-thresholds)
npm run test:coverage

# Documentatiecheck: links, ankers, versies en config-waarden
npm run check:docs

# Live contract test tegen de echte API (vereist API_KEY)
API_KEY=ga_test_... npm run test:live

# Smoke-test: pakt + installeert + start het echte pakket
npm run test:package

# Typecheck / lint afzonderlijk
npm run typecheck
npm run lint

# Bouwen naar dist/
npm run build

CI は、プッシュ／PR ごとに .github/workflows/ci.yml のチェックを自動実行し、公開前には .github/workflows/release.yml のチェックを実行します。

サーバーをローカルで実行する

サーバーは stdio を介して MCP クライアントと通信します。手動ですばやく確認するには、サーバーを直接起動し、stdin に JSON-RPC メッセージを送信します。

# Start de server (met een geldige ga_live_/ga_test_ key)
API_KEY="ga_test_1234567890" node dist/bin.js

続いて、たとえば次の行を stdin に送信します。

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"cli","version":"1.0.0"}}}

すべてのログ行は stderr に出力され、stdout には JSON-RPC のみが出力されます。これにより、サーバーが正しく起動するか、利用可能なツールをすぐに確認できます。

MCP クライアントで実行する

MCP サーバーの設定にある設定を使用してください。クライアントが stdio（command: "npx"）を介してサーバーを起動し、env を介して API キーを渡します。ポートや URL は必要ありません。

バージョン

更新と改善の一覧については、CHANGELOGを参照してください。

ライセンス

MIT License の詳細については、LICENSEを参照してください。

サポート

質問、バグ、提案については、以下からお問い合わせください。

• Email: [email protected]
• GitHub Issues: https://github.com/GetApiNL/mcp-server/issues

---

注意：このサーバーは有効な GetApi API キーがある場合にのみ動作します。有効な API キーがないと、サーバーは動作しません。