AI 어시스턴트가 지리적 위치, 네트워크 소유권, 개인정보 보호 탐지를 포함한 IP 인텔리전스 조회를 수행할 수 있습니다.
다른 이름 ipinfo/mcp, mcp, ipinfo-mcp-server
- 스타
- 2
- Tools
- 6
- 다운로드, 30일
- 1,367
- 최신 버전
- 0.3.2
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- Apache-2.0
IPinfo MCP란?
AI 어시스턴트가 지리적 위치, 네트워크 소유권, 개인정보 보호 탐지를 포함한 IP 인텔리전스 조회를 수행할 수 있습니다. 6개 도구를 제공합니다. 예: ipinfo_lookup, ipinfo_check_privacy, ipinfo_check_residential_proxy.
프로젝트 README에서 생성된 요약
IPinfo MCP server 정보
IPinfo MCP server는 AI 어시스턴트가 상세한 IP 인텔리전스 조회를 수행할 수 있는 기능을 제공합니다. 사용자는 지리적 위치 데이터, 네트워크 소유권, VPN 또는 Tor 사용 여부와 같은 개인정보 보호 지표를 쿼리할 수 있습니다. 이 server는 Claude Desktop과 같은 MCP 호환 클라이언트를 사용하는 개발자를 위해 설계되었으며, PyPI를 통해 stdio를 사용하는 로컬 server로 배포하거나 HTTP를 통해 원격 hosted server로 배포할 수 있습니다.
사용자는 Lite, Core, Plus, Residential Proxy 티어를 포함한 IPinfo 계정 플랜에 따라 다양한 수준의 데이터에 액세스할 수 있습니다. 이 server에는 전체 메타데이터를 위한 ipinfo_lookup, 지리적 세부 정보를 위한 ipinfo_geolocate, 익명 연결 탐지를 위한 ipinfo_check_privacy와 같은 특정 도구가 포함되어 있습니다. 로컬 설정의 경우 인증은 IPINFO_TOKEN 환경 변수를 통해 처리되며, hosted 버전은 보안 액세스를 위해 OAuth를 활용합니다.
활용 사례
- 1IP 지리적 위치 식별어시스턴트에게 특정 IP 주소와 관련된 도시, 지역 또는 좌표를 찾아달라고 요청하세요.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
IPinfo MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 IPinfo MCP 설치
$ claude mcp add --env 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' mcp -- uvx ipinfo-mcp-serverCursor에 IPinfo MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"ipinfo-mcp-server"
],
"env": {
"IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
}
}
}
}VS Code에 IPinfo MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"ipinfo-mcp-server"
],
"env": {
"IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
}
}
}
}VS Code CLI에 IPinfo MCP 설치
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"uvx","args":["ipinfo-mcp-server"],"env":{"IPINFO_TOKEN":"<YOUR_IPINFO_TOKEN>"}}'Claude Desktop에 IPinfo MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"ipinfo-mcp-server"
],
"env": {
"IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
}
}
}
}Codex에 IPinfo MCP 설치
$ codex mcp add mcp --env 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' -- uvx ipinfo-mcp-serverCodex config.toml에 IPinfo MCP 설치
~/.codex/config.toml
[mcp_servers.mcp] command = "uvx" args = ["ipinfo-mcp-server"] [mcp_servers.mcp.env] IPINFO_TOKEN = "<YOUR_IPINFO_TOKEN>"
Gemini CLI에 IPinfo MCP 설치
$ gemini mcp add -s user -e 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' mcp uvx -- ipinfo-mcp-serverGemini settings.json에 IPinfo MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"ipinfo-mcp-server"
],
"env": {
"IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
}
}
}
}HostedMCP가 2026년 11월 16일에 실행 확인
ipinfo-mcp-server 0.3.2을(를) 네트워크와 키가 없는 격리된 컨테이너에서 이 명령으로 실행했습니다. 응답하며 도구 6개를 보여 주었습니다.
IPinfo MCP 도구 6
tools/list로 서버에서 직접 읽음ipinfo_lookup읽기 전용Look up geolocation, network, and metadata for one or more IP addresses. By default queries the IPinfo Lite endpoint, which returns country, continent, and ASN info. Set detailed=True to query the full lookup endpoint, which adds city-level geolocation, privacy flags (VPN, proxy, Tor, hosting, anycast), and richer AS data. Results are paginated. Use page and page_size to control which slice is returned. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_check_privacy읽기 전용Check whether IP addresses are using privacy or anonymity services. Returns privacy flags for each IP: whether it is anonymous, using a VPN, proxy, relay, or Tor, and whether it is an anycast, hosting, mobile, or satellite address. Requires an IPinfo plan that includes privacy detection. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Do not treat a missing result as "no privacy services detected": check errors. Results are cached in memory for the session, so repeat checks of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_check_residential_proxy읽기 전용Check whether IP addresses are known residential proxies. Returns whether each IP is a residential proxy and, if so, the proxy service name, the date it was last seen, and the percentage of days the IP was observed as a proxy. Requires an IPinfo plan with residential proxy access. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Do not treat a missing result as "not a residential proxy": check errors. Results are cached in memory for the session, so repeat checks of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_geolocate읽기 전용Get geographic location data for one or more IP addresses. By default queries the IPinfo Lite endpoint, which returns country and continent. Set detailed=True to query the full lookup endpoint, which adds city, region, coordinates, timezone, and postal code. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_asn읽기 전용Get autonomous system (network ownership) information for IP addresses. By default queries the IPinfo Lite endpoint, which returns ASN, name, and domain. Set detailed=True to query the full lookup endpoint, which also includes the network type (e.g. isp, hosting, business, education). Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_quota읽기 전용Check your IPinfo API usage and remaining quota. Returns daily and monthly request counts, the plan limit, and how many requests remain.
| ipinfo_lookup | Look up geolocation, network, and metadata for one or more IP addresses. By default queries the IPinfo Lite endpoint, which returns country, continent, and ASN info. Set detailed=True to query the full lookup endpoint, which adds city-level geolocation, privacy flags (VPN, proxy, Tor, hosting, anycast), and richer AS data. Results are paginated. Use page and page_size to control which slice is returned. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. | 읽기 전용 |
| ipinfo_check_privacy | Check whether IP addresses are using privacy or anonymity services. Returns privacy flags for each IP: whether it is anonymous, using a VPN, proxy, relay, or Tor, and whether it is an anycast, hosting, mobile, or satellite address. Requires an IPinfo plan that includes privacy detection. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Do not treat a missing result as "no privacy services detected": check errors. Results are cached in memory for the session, so repeat checks of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. | 읽기 전용 |
| ipinfo_check_residential_proxy | Check whether IP addresses are known residential proxies. Returns whether each IP is a residential proxy and, if so, the proxy service name, the date it was last seen, and the percentage of days the IP was observed as a proxy. Requires an IPinfo plan with residential proxy access. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Do not treat a missing result as "not a residential proxy": check errors. Results are cached in memory for the session, so repeat checks of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. | 읽기 전용 |
| ipinfo_geolocate | Get geographic location data for one or more IP addresses. By default queries the IPinfo Lite endpoint, which returns country and continent. Set detailed=True to query the full lookup endpoint, which adds city, region, coordinates, timezone, and postal code. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. | 읽기 전용 |
| ipinfo_asn | Get autonomous system (network ownership) information for IP addresses. By default queries the IPinfo Lite endpoint, which returns ASN, name, and domain. Set detailed=True to query the full lookup endpoint, which also includes the network type (e.g. isp, hosting, business, education). Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts. | 읽기 전용 |
| ipinfo_quota | Check your IPinfo API usage and remaining quota. Returns daily and monthly request counts, the plan limit, and how many requests remain. | 읽기 전용 |
구성
IPINFO_TOKEN필수비밀Your IPinfo API token. Get a free one at https://ipinfo.io/signup
IPINFO_TRANSPORT
| 이름 | 설명 | 유형 |
|---|---|---|
| IPINFO_TOKEN | Your IPinfo API token. Get a free one at https://ipinfo.io/signup | 필수비밀 |
| IPINFO_TRANSPORT | — |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기IPinfo MCP Server
The official IPinfo MCP Server lets AI assistants such as Claude answer questions about IP addresses. Ask where an IP is located, which company or network it belongs to, or whether it's a VPN, proxy, Tor exit node, or residential proxy, and the assistant looks it up with IPinfo data.
It implements the Model Context Protocol (MCP), the open standard AI assistants use to connect to external tools, so it works with any MCP-compatible client. It supports the IPinfo Lite, Core, Plus, and Residential Proxy plans.
For the full guide, see the official documentation.
Installation
You need an IPinfo account. Sign up for free at ipinfo.io/signup.
Hosted server
Point your MCP client at https://mcp.ipinfo.io/ (Streamable HTTP). The first time it connects, it asks you to sign in with your IPinfo account through OAuth.
Local server (PyPI)
The server is published on PyPI as ipinfo-mcp-server and runs over stdio, authenticating with your API token. With uv installed, add it to your MCP client configuration:
{
"mcpServers": {
"ipinfo": {
"command": "uvx",
"args": ["ipinfo-mcp-server"],
"env": {
"IPINFO_TOKEN": "<your-ipinfo-token>"
}
}
}
}
Claude Desktop extension
Download mcp.mcpb from the latest GitHub release and open it with Claude Desktop. You'll be asked for your API token during installation.
MCP Registry
The server is listed in the MCP Registry as io.github.ipinfo/mcp.
The server is also listed on LightNow.
Tools
| Tool | Description | Plan requirement |
|---|---|---|
ipinfo_lookup |
Full IP data: geolocation, network, and metadata | Any; detailed: true needs Core/Plus |
ipinfo_geolocate |
Geographic location | Any; detailed: true needs Core/Plus |
ipinfo_asn |
Autonomous system (network ownership) | Any; detailed: true needs Core/Plus |
ipinfo_check_privacy |
VPN, proxy, relay, Tor, hosting, anycast, mobile, satellite flags | Paid plan |
ipinfo_check_residential_proxy |
Residential proxy detection | Residential Proxy access |
ipinfo_quota |
API usage and remaining quota | Any |
ipinfo_lite_lookup |
Lite IP data, for agents without an account | None; only offered to AAuth agents |
Tools that lack access for the token's plan return an ACCESS_DENIED error.
Common parameters
All tools except ipinfo_quota take a list of IPs and are paginated:
| Parameter | Type | Default | Description |
|---|---|---|---|
ips |
string[] |
required | Public IPv4 or IPv6 addresses. Private, loopback, reserved, multicast, and bogon addresses are rejected and reported in validation_errors. |
page |
integer |
1 |
1-based page of the result set. Values below 1 are clamped to 1. |
page_size |
integer |
25 |
IPs resolved per page, up to 1000. Only IPs on the requested page are fetched, so smaller pages consume less quota per call. |
ipinfo_lookup, ipinfo_geolocate, and ipinfo_asn also take:
| Parameter | Type | Default | Description |
|---|---|---|---|
detailed |
boolean |
false |
false queries the Lite endpoint. true queries the full lookup endpoint, which returns more fields. |
Common output
IP-based tools return:
| Field | Description |
|---|---|
results |
Object keyed by IP with the tool-specific data below. |
errors |
Object keyed by IP for IPs the API returned an error for. These IPs are left out of results. |
validation_errors |
Object keyed by input for values that aren't valid public IPs. Only present when there are any. |
_pagination |
total_results, page, page_size, total_pages, has_next, has_previous. |
_meta |
api_calls_made and from_cache. Results are cached in memory, so repeat lookups don't consume API quota. |
If the whole request fails (for example a missing or invalid token), the tool returns an error object instead, with code (ACCESS_DENIED, RATE_LIMITED, INVALID_TOKEN, NO_TOKEN, API_ERROR, or UNKNOWN), message, and suggestion.
ipinfo_lookup
Returns the raw IPinfo API response for each IP.
detailed: false(Lite):ip,asn,as_name,as_domain,country,country_code,continent,continent_code.detailed: true(full lookup):ip,hostname,geo(city, region, country, continent, coordinates, timezone, postal code),as(ASN, name, domain, type),anonymous(proxy, relay, Tor, VPN),mobile, and theis_anonymous,is_anycast,is_hosting,is_mobile,is_satelliteflags. Some fields are only available on Plus.
ipinfo_geolocate
Returns, per IP: ip, country, country_code, continent, continent_code. With detailed: true, also city, region, region_code, latitude, longitude, timezone, postal_code.
ipinfo_asn
Returns, per IP: ip, asn, name, domain. With detailed: true, also type (isp, hosting, business, education) and last_changed.
ipinfo_check_privacy
Returns, per IP: ip, is_anonymous, anonymous (is_proxy, is_relay, is_tor, is_vpn), is_anycast, is_hosting, is_mobile, is_satellite.
ipinfo_check_residential_proxy
Returns, per IP: ip and is_residential_proxy. For residential proxies, also service (proxy service name), last_seen (date), and percent_days_seen.
ipinfo_quota
Takes no parameters. Returns token (omitted when connected with OAuth), requests (day, month, limit, remaining), and per-feature quotas under features.
ipinfo_lite_lookup
Only offered to agents that sign their requests with AAuth, who get it in place of the tools above. Takes the common parameters and returns the Lite data for each IP: ip, asn, as_name, as_domain, country, country_code, continent, continent_code. When the daily limit for lookups without an account is reached, it returns a RATE_LIMITED error.
Configuration
The server is configured through environment variables:
| Variable | Default | Description |
|---|---|---|
IPINFO_TOKEN |
API token (stdio transport; over HTTP the token comes from the request) | |
IPINFO_API_BASE_URL |
https://api.ipinfo.io |
Base URL for api.ipinfo.io endpoints |
IPINFO_LEGACY_BASE_URL |
https://ipinfo.io |
Base URL for legacy ipinfo.io endpoints (e.g. /me) |
IPINFO_CACHE_TTL |
3600 |
Seconds a cached IP result stays fresh |
IPINFO_TRANSPORT |
stdio |
Transport type (stdio or http) |
HOST |
0.0.0.0 |
HTTP host (only for http transport) |
PORT |
8000 |
HTTP port (only for http transport) |
IPINFO_OAUTH_ISSUER |
OAuth issuer whose access tokens are accepted; OAuth is off when unset | |
IPINFO_MCP_RESOURCE_URL |
Public URL of this server, required with IPINFO_OAUTH_ISSUER |
|
IPINFO_OAUTH_JWKS_URI |
<issuer>/.well-known/jwks.json |
Where the issuer publishes its signing keys |
IPINFO_OPENAI_APPS_CHALLENGE |
Token served at /.well-known/openai-apps-challenge for OpenAI's domain verification |
|
IPINFO_AAUTH_PROVIDER_KEY |
Ed25519 private key, PEM encoded, for AAuth; AAuth is off when unset | |
IPINFO_AAUTH_ISSUER |
Public URL of this server for AAuth, required with the key |
With the http transport, each request authenticates with its own Authorization: Bearer <token> header.
Setting IPINFO_OAUTH_ISSUER turns on OAuth for the http transport. The server then advertises the issuer at /.well-known/oauth-protected-resource, answers requests without a valid credential with 401 Unauthorized, and verifies access tokens against the issuer's signing keys. A verified access token is sent to the IPinfo API in place of an API token. API tokens keep working as before.
Setting IPINFO_AAUTH_PROVIDER_KEY turns on AAuth for the http transport, so agents that sign their requests with AAuth can use ipinfo_lite_lookup without an IPinfo account. Generate the key with openssl genpkey -algorithm ed25519, and give every replica the same one. IPINFO_AAUTH_ISSUER must be the server's public URL: https, no port, path, or trailing slash. With AAuth on, the server also serves:
/aauth, the MCP endpoint for AAuth agents, whose only tool isipinfo_lite_lookup. Listing its tools needs no signature; calling one needs an AAuth signature. WhenIPINFO_MCP_RESOURCE_URLis set, only signatures made for that host are accepted./.well-known/aauth-resource.json, which points agents at/aauth. It names the origin ofIPINFO_MCP_RESOURCE_URL, or ofIPINFO_AAUTH_ISSUERwhen that is unset./.well-known/aauth-agent.jsonand/.well-known/aauth-jwks.json, the documents of the server's own AAuth agent,aauth:ipinfo-mcp@<issuer host>.
The main endpoint is unaffected.
Feedback
- Bugs and feature requests: open an issue on GitHub Issues.
- Security vulnerabilities: don't open a public issue; follow the security policy.
- Questions about your IPinfo account or plan: contact support@ipinfo.io.
Contributing
Contributions are welcome. See CONTRIBUTING.md for the workflow and the requirements a change has to meet.
Development
Prerequisites
- Python 3.14+
- uv
Setup
uv sync --dev
cp .env.example .env
# Add your IPinfo token to .env
Running the server
The server supports two transports: stdio (default) and HTTP.
# stdio (default, used by MCP clients)
uv run ipinfo-mcp-server
# HTTP
IPINFO_TRANSPORT=http HOST=0.0.0.0 PORT=8000 uv run ipinfo-mcp-server
Tests
# All tests
uv run pytest
# Integration tests (requires IPINFO_TOKEN)
uv run pytest tests/integration/
Integration tests hit the real IPinfo API and validate response structure only (no exact value assertions). They require IPINFO_TOKEN to be set and are skipped otherwise.
Type checking
uv run pyright
Linting
uv run ruff check .
uv run ruff format .
IPinfo MCP 질문
IPinfo MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' mcp -- uvx ipinfo-mcp-server를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
IPinfo MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
IPinfo MCP는 어떤 도구를 제공하나요?
6개 도구를 제공합니다. 예: ipinfo_lookup, ipinfo_check_privacy, ipinfo_check_residential_proxy, ipinfo_geolocate, ipinfo_asn.
IP 주소에 대해 어떤 정보를 얻을 수 있나요?
지리적 위치, 네트워크 소유권(ASN) 및 해당 IP가 VPN, 프록시, Tor exit node 또는 주거용 프록시인지와 같은 메타데이터를 확인할 수 있습니다.
이 MCP server는 OAuth를 지원하나요?
네, hosted HTTP server를 사용하는 경우 첫 연결 시 OAuth를 통해 IPinfo 계정으로 로그인해야 합니다.
IP가 주거용 프록시인지 확인할 수 있나요?
네, 주거용 프록시 탐지를 위한 ipinfo_check_residential_proxy라는 전용 도구가 있습니다.