智能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:httpHTTP配置
MCP_TRANSPORT=http或--transport=http启用流式HTTP模式PORT或MCP_PORT设置侦听端口。默认值:3000HOST或MCP_HOST设置绑定主机。违约:0.0.0.0MCP_PATH设置MCP端点路径。违约:/mcpGET /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
