MCP Server IP 归属地查询服务器

这是一个基于 Model Context Protocol (MCP) 的服务器，提供 IP 地址归属地查询功能。它使用 ip.sb 的 API 来获取 IP 地址的详细地理位置信息。

功能特点

• 查询指定 IP 地址的归属地信息
• 如果不指定 IP 地址，则查询当前客户端的 IP 信息
• 通过 HTTP SSE 方式提供数据传输
• 符合 MCP 协议标准

安装

# 克隆仓库
git clone https://github.com/yourusername/mcp-server-ip-npx.git
cd mcp-server-ip-npx

# 安装依赖
npm install

# 构建项目
npm run build

使用方法

方式一：使用 npx 直接运行（推荐）

无需安装，直接使用 npx 运行：

# 使用默认端口 3000 启动服务器
npx mcp-server-ip-npx

# 指定端口启动服务器
npx mcp-server-ip-npx --port=8080

# 查看帮助信息
npx mcp-server-ip-npx --help

注意: 要使 npx 命令正常工作，需要先将包发布到 npm。如果是本地开发，请使用方式二。

方式二：本地安装运行

# 克隆仓库
git clone https://github.com/yourusername/mcp-server-ip-npx.git
cd mcp-server-ip-npx

# 安装依赖
npm install

# 构建项目
npm run build

启动服务器

# 使用生产模式启动
npm start

# 或者使用 bin 命令启动
npm run bin

# 或者直接运行编译后的文件
node dist/bin.js

服务器将在指定端口上启动，并通过 SSE 提供 MCP 服务。

发布到 npm

如果要让其他人通过 npx 使用这个包，需要发布到 npm：

# 登录 npm（如果还没有登录）
npm login

# 发布包
npm publish

发布后，其他人就可以使用 npx mcp-server-ip-npx 直接运行了。

开发模式

npm run dev

与 Claude Desktop 集成

1. 在项目下创建 .cursor/mcp.json：

2. 添加服务器配置：

{
  "mcpServers": {
    "sample-project-server": {
      "url": "http://localhost:3000/sse"
    }
  }
}

API 说明

query-ip

查询指定 IP 地址的归属地信息。

参数:

• ip (可选): 要查询的 IP 地址。如果不提供，则查询当前客户端的 IP。

返回: 返回包含以下信息的文本：

• IP 地址
• 国家/地区
• 省/州
• 城市
• 经纬度
• 时区
• ASN
• 组织

参考

• MCP 协议
• TypeScript SDK
• Claude MCP
• ip.sb