ip-info-mcp

Сервер запроса информации об IP-адресах на основе протокола MCP (Model Context Protocol), взаимодействующий с AI-клиентами через транспортный уровень stdio.

Возможности

• Проверка локального IP — получение текущего публичного IP-адреса и информации о его местоположении

• Проверка указанного IP — запрос для любого IP-адреса: местоположение, провайдер, координаты и т.д.

• Комплексный запрос — поддержка IPv4/IPv6, включая имя хоста, организацию, почтовый индекс, часовой пояс и т.д.

Related MCP server: personal-mcp-server

Механизм связи MCP stdio

В этом проекте используется транспортный уровень stdio протокола MCP:

┌─────────────────┐         ┌──────────────────────┐
│  AI 客户端        │  stdin  │  MCP Server (本进程)  │
│  (CodeBuddy 等)   │◄───────►│  python server.py     │
│                   │  stdout │                       │
└─────────────────┘         └──────────────────────┘

• Клиент отправляет JSON-RPC запросы (например, tools/call) через stdin

• Сервер возвращает JSON-RPC ответы через stdout

• stderr используется для вывода журналов и не влияет на протокол связи

• Не требуется HTTP-сервер, лёгкий запуск, подходит для интеграции с локальными инструментами

Быстрый старт

1. Установка зависимостей

pip install -r requirements.txt

2. Настройка в AI-клиенте

В CodeBuddy в Settings → MCP → Add MCP добавьте:

{
  "mcpServers": {
    "ip-info": {
      "type": "stdio",
      "command": "python",
      "args": ["path/to/server.py"],
      "description": "IP 地址信息查询工具"
    }
  }
}

3. Использование

После настройки просто задавайте вопросы в диалоге:

• «Какой у меня публичный IP?»

• «Запросить местоположение 8.8.8.8»

• «Проверить информацию об этом IP: 114.114.114.114»

Структура проекта

ip-info-mcp/
├── server.py          # MCP 服务器主文件
├── requirements.txt   # Python 依赖
├── README.md          # 本文件
└── chatmcp.yaml       # chatmcp 平台配置

Технологический стек

• MCP Python SDK — реализация протокола MCP

• httpx — асинхронный HTTP-клиент

• ip-api.com / ipinfo.io — бесплатные API для запроса информации об IP

Лицензия

MIT