Ip Region And Ping A Test Mcp

IPCONFIG MCP サーバー

中国語ドキュメント | 英語

Cloudflare Workers 上に構築された強力な IPCONFIG MCP（Model Context Protocol）サーバーです。AI アシスタント向けに、IP アドレスの検索、位置情報の取得、ネットワーク接続テストのツールを提供します。

🌟 特長

• IP アドレス検索 - 現在のクライアントのパブリック IP アドレスを取得します
• IP 位置情報 - 任意の IP アドレスの詳細な地理的位置情報を取得します
• Ping 接続テスト - 任意のホストへのネットワーク接続と遅延をテストします
• CORS 対応 - CORS に完全対応し、あらゆるドメインからアクセスできます
• 高性能 - Cloudflare Workers のエッジコンピューティングプラットフォーム上に構築されています
• 標準プロトコル - MCP プロトコル仕様に完全に準拠しています

🔑 API キーの取得

MCP クライアントを設定する前に、IPCONFIG から API キーを取得する必要があります。

手順

1. アカウントを作成

   • IPCONFIG Console にアクセスします
   • 無料アカウントに登録するか、すでにアカウントをお持ちの場合はログインします

2. API キー管理にアクセス

   • コンソールの API Keys page に移動します
   • API キー管理ダッシュボードが表示されます

3. 新しい API キーを作成

   • 「Create New Key」ボタンをクリックします
   • API キーを識別しやすい名前（例：「MCP Client」「Claude Desktop」）を入力します
   • 「Create」をクリックします

4. キーを保存

   • ⚠️ 重要：API キーをすぐにコピーし、安全な場所に保管してください
   • セキュリティ上の理由により、キーが表示されるのは一度だけです
   • 紛失した場合は、新しいキーを作成する必要があります

API キーの特長

特長	無料プラン	Pro プラン
レート制限	60 リクエスト/分	100 リクエスト/秒
月間クレジット	1,000	10,000+
自分の IP を取得	✅ 無料	✅ 無料
IP 位置情報	1 クレジット/クエリ	1 クレジット/クエリ
Ping テスト	1 クレジット/ノード	1 クレジット/ノード

詳細については、API キー管理ドキュメントをご覧ください。

🚀 クイックスタート

ユーザー向け

Cursor IDE の設定（推奨）

ワンクリックインストール：

手動設定：

• macOS：~/Library/Application Support/Cursor/mcp.json
• Windows：%APPDATA%\Cursor\mcp.json
• Linux：~/.config/Cursor/mcp.json

{
  "mcpServers": {
    "ipconfig": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.ipconfig.com/mcp"],
      "env": {
        "IPCONFIG_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop の設定

1. API キーを取得：上記の API キー取得ガイドに従って API キーを取得します

2. Claude Desktop を設定：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

3. 設定を追加：

   {
     "mcpServers": {
       "ipconfig": {
         "command": "npx",
         "args": ["mcp-remote", "https://mcp.ipconfig.com/mcp"],
         "env": {
           "IPCONFIG_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

4. Claude Desktop を再起動し、「自分の IP アドレスは？」と尋ねてテストします

開発者向け

1. リポジトリをクローン

git clone https://github.com/your-username/ipconfig-mcp.git
cd ipconfig-mcp

2. 依存関係をインストール

npm install

3. 環境を設定

# Copy configuration file
cp wrangler.toml.example wrangler.toml

# Edit configuration (optional)
# - Modify project name
# - Configure custom domain
# - Set language preference

4. API キーを設定（推奨）

wrangler secret put IPCONFIG_API_KEY
# Enter your API key (follow the API Key guide above to obtain one)

5. ローカル開発

npm run dev
# Server will start at http://localhost:8787

6. Cloudflare にデプロイ

npm run deploy

📡 MCP ツール

1. get_my_ip - 現在の IP アドレスを取得

現在のクライアントのパブリック IP アドレスと基本情報を取得します。

パラメーター：

• format（任意）：json または text。デフォルトは json です

使用例：

• 「自分の IP アドレスは？」
• 「現在の IP 情報を表示して」
• 「パブリック IP をテキスト形式で取得して」

呼び出し例：

{
  "name": "get_my_ip",
  "arguments": {"format": "json"}
}

応答例：

{
  "ip": "203.0.113.1",
  "country": "United States",
  "region": "California",
  "city": "San Francisco",
  "isp": "Example ISP",
  "timezone": "America/Los_Angeles"
}

2. get_ip_location - IP ジオロケーション検索

任意の IP アドレスの詳細な地理的位置情報を取得します。

パラメーター:

• ip（必須）：IP アドレス（IPv4 または IPv6）
• format（任意）：json または text。デフォルトは json

使用例:

• 「8.8.8.8 はどこにありますか？」
• 「1.1.1.1 の位置情報を取得してください」
• 「この IP の地理的位置はどこですか：208.67.222.222？」

呼び出し例:

{
  "name": "get_ip_location",
  "arguments": {"ip": "8.8.8.8", "format": "json"}
}

応答例:

{
  "ip": "8.8.8.8",
  "country": "United States",
  "region": "California",
  "city": "Mountain View",
  "latitude": 37.4056,
  "longitude": -122.0775,
  "isp": "Google LLC",
  "asn": "AS15169",
  "timezone": "America/Los_Angeles"
}

3. ping_test - ネットワーク接続テスト

世界各地の複数の場所から、任意のホストへのネットワーク接続とレイテンシをテストします。

パラメーター:

• host（必須）：ホスト名または IP アドレス
• count（任意）：ping の回数。デフォルトは 2、範囲は 1～10
• ipVersion（任意）：ipv4 または ipv6。デフォルトは ipv4
• areas（任意）：テストする地域のリスト。デフォルトは主要地域

使用例:

• 「google.com への接続をテストしてください」
• 「複数の場所から baidu.com に ping を送信してください」
• 「example.com のサーバーへのネットワークレイテンシを確認してください」

呼び出し例:

{
  "name": "ping_test",
  "arguments": {
    "host": "google.com", 
    "count": 4,
    "areas": ["california", "london", "tokyo"]
  }
}

応答例:

{
  "host": "google.com",
  "results": [
    {
      "area": "california",
      "avg_latency": "12.5ms",
      "packet_loss": "0%",
      "status": "success"
    },
    {
      "area": "london", 
      "avg_latency": "45.2ms",
      "packet_loss": "0%",
      "status": "success"
    }
  ]
}

🔧 設定

環境変数

wrangler.toml で設定します：

[vars]
MCP_SERVER_NAME = "IPCONFIG MCP Server"
MCP_SERVER_VERSION = "1.0.0"
LANGUAGE = "en"  # or "zh" for Chinese

多言語サポート

• 環境変数：export LANGUAGE=zh
• クライアント設定：MCP 設定で "LANGUAGE": "zh" を設定
• リクエストパラメーター：MCP リクエストに "language": "zh" を含める

API キーの設定

• 本番環境：wrangler secret put IPCONFIG_API_KEY を使用
• クライアント：MCP 設定の env セクションで設定
• キーの取得：上記の API キーガイドに従ってください

🧪 テスト

ヘルスチェック

curl https://mcp.ipconfig.com/health

MCP ツールのテスト

# Get tools list
curl -X POST https://mcp.ipconfig.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Test tool call
curl -X POST https://mcp.ipconfig.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": {"name": "get_my_ip", "arguments": {"format": "json"}}
  }'

MCP Inspector の使用

npx @modelcontextprotocol/inspector@latest
# Visit http://localhost:5173 in browser
# Connect to: https://mcp.ipconfig.com/mcp

📊 API キーの使用制限

API キーの種類	リクエスト数/分	リクエスト数/日	機能
Free	100	1,000	基本機能
Pro	600	10,000	すべての機能
Enterprise	2,000	50,000	高度な機能

🏗️ プロジェクト構成

ipconfig-mcp/
├── src/
│   ├── index.ts              # Main entry file
│   ├── services/
│   │   └── ipconfig.ts       # IPCONFIG API service
│   └── utils/
│       ├── cors.ts           # CORS utilities
│       └── i18n.ts           # Internationalization
├── wrangler.toml.example     # Configuration template
├── cursor-mcp-config.json    # Cursor IDE configuration
├── package.json              # Project dependencies
├── tsconfig.json             # TypeScript configuration
└── README.md                 # Project documentation

🔗 リンク

• IPCONFIG のウェブサイト
• MCP ランディングページ
• Model Context Protocol
• Cloudflare Workers

❓ よくある質問

Q: 設定が正しく動作していることを確認するにはどうすればよいですか？ A: クライアントを再起動し、AI に「自分の IP アドレスは何ですか？」と尋ねてください。結果が返されれば、設定は成功です。

Q: 接続エラーが発生した場合はどうすればよいですか？ A: ネットワーク接続を確認し、API キーが正しいことを確かめ、設定ファイルの形式が有効であることを確認してください。

Q: どのような機能に対応していますか？ A: 現在の IP アドレスの検索、IP ジオロケーション、ネットワーク接続テストに対応しており、IPv4 と IPv6 の両方で利用できます。

📄 ライセンス

MIT License

🤝 貢献

Issue とプルリクエストを歓迎します！

---

IPCONFIG MCP Server - AI アシスタントにネットワーク診断機能を提供します 🚀