AI导哈

地理编码工具

Intellipins MCP 是一个提供地址地理编码和反向地理编码功能的服务器，支持通过 stdio 和 Streamable HTTP 进行访问。

  • by codingtales
  • JavaScript
  • 混合部署
  • 更新于
在 GitHub 查看 codingtales/pins-mcp

使用说明

智能MCP

一个MCP服务器，通过stdio和Streamable HTTP公开Intellipin地址地理编码工具。

先决条件

  • 已安装Node.js
  • 已安装Claude Code CLI： npm install -g @anthropic-ai/claude-code
  • Intellipins API密钥

设置

步骤1--克隆项目

~/Library/CloudStorage/.../Intellipins/projects/pins-mcp/

或者把它放在任何地方——只要记下路径。

步骤2——构建服务器

cd /path/to/pins-mcp
npm install
npm run build

这产生 dist/index.js.

步骤3-添加您的API密钥

将密钥存储在 ~/.claude/.env:

# ~/.claude/.env
INTELLIPINS_API_KEY=your_api_key_here

然后将此行添加到您的shell配置文件中(~/.zshrc)因此，关键在于Claude Code启动时的环境——MCP服务器从那里继承了它：

# ~/.zshrc
export INTELLIPINS_API_KEY=$(grep INTELLIPINS_API_KEY ~/.claude/.env | cut -d= -f2)

这会把钥匙放在一个地方(.env)并避免复制它。

然后重新加载shell：

source ~/.zshrc

步骤4——使用克劳德代码注册MCP

claude mcp add intellipins \
  node "/path/to/pins-mcp/dist/index.js"

注意：不要将密钥作为标志传递——服务器会从环境中获取它。

第5步——验证

claude mcp list

您应该看到：

intellipins: ... ✓ Connected

通过流式HTTP托管

服务器仍然默认为本地MCP客户端的stdio，但现在可以作为托管的Streamable HTTP服务器运行。

在HTTP模式下本地运行

cd /path/to/pins-mcp
npm run build
MCP_TRANSPORT=http PORT=3000 npm run start:http

您还可以使用dev入口点：

MCP_TRANSPORT=http PORT=3000 npm run dev:http

HTTP配置

  • MCP_TRANSPORT=http 或 --transport=http 启用流式HTTP模式
  • PORT 或 MCP_PORT 设置侦听端口。默认值： 3000
  • HOST 或 MCP_HOST 设置绑定主机。违约： 0.0.0.0
  • MCP_PATH 设置MCP端点路径。违约： /mcp
  • GET /health 返回一个简单的健康响应以进行部署检查

例子：

HOST=0.0.0.0 PORT=8080 MCP_PATH=/mcp MCP_TRANSPORT=http node dist/index.js

然后，MCP端点将在以下位置可用：

http://localhost:8080/mcp

可用工具

  • geocode_forward --地址→ 坐标
  • geocode_reverse --坐标→ 地址
  • parcel_lookup --查找包裹数据以获取地址
  • postal_city_lookup --查找城市/州的邮政编码
  • property_search_urls --为房产生成Zillow/Redfin搜索URL

相关 MCP