Gps Trust MCP Proxy User

GPS Trust MCP 代理

连接Claude Desktop和Claude Code至GPS Trust MCP服务器的Python代理 https://gt.aussierobots.com.au/mcp。

快速入门

1. 克隆此仓库

git clone https://github.com/aussierobots/gps-trust-mcp-proxy-user.git
cd gps-trust-mcp-proxy-user

2. 安装依赖项

需要 Python 3.14+ 及以上版本 紫外线：

uv sync

这将会：

• 在（某个地方/系统中）创建一个虚拟环境 .venv/
• 安装FastMCP 2.12+及其依赖项
• 生成 uv.lock 文件

3. 获取您的API密钥

请联系您的GPS Trust管理员以获取API密钥。

4. 配置Claude桌面版

macOS（苹果电脑操作系统）编辑 ~/Library/Application Support/Claude/claude_desktop_config.json Windows编辑 %APPDATA%\Claude\claude_desktop_config.json

添加此配置（替换路径和API密钥）：

{
  "mcpServers": {
    "gps-trust": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/gps-trust-mcp-proxy-user",
        "gt-mcp-proxy"
      ],
      "env": {
        "GPSTRUST_API_KEY": "your-api-key-here"
      }
    }
  }
}

macOS 示例:

{
  "mcpServers": {
    "gps-trust": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/yourname/gps-trust-mcp-proxy-user",
        "gt-mcp-proxy"
      ],
      "env": {
        "GPSTRUST_API_KEY": "your-actual-api-key"
      }
    }
  }
}

Windows 示例：

{
  "mcpServers": {
    "gps-trust": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\yourname\\gps-trust-mcp-proxy-user",
        "gt-mcp-proxy"
      ],
      "env": {
        "GPSTRUST_API_KEY": "your-actual-api-key"
      }
    }
  }
}

5. 重启Claude桌面版

保存配置后，重启Claude桌面应用。GPS信任工具应出现在工具栏中。

备选方案：克劳德代码

创建或编辑 .claude/config.json 在你的项目中：

{
  "mcpServers": {
    "gps-trust": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/gps-trust-mcp-proxy-user",
        "gt-mcp-proxy"
      ],
      "env": {
        "GPSTRUST_API_KEY": "your-api-key-here"
      }
    }
  }
}

然后跑 /mcp reload 在克劳德代码中。

可用工具

一旦连接成功，您将能够使用23+个GPS信任MCP工具：

• 实体信息 (1个工具) - 查找您的API密钥的实体类型和功能
• 设备读数 （5种工具）- 当前设备状态（位置、卫星、轨道、安全、元数据）
• 设备历史 （4种工具）- 历史位置数据、轨迹和精度趋势
• 实体发现 （7个工具）- 在您的账户中发现机器人、站点和设备
• GPS信任地图 (3种工具) - 通过位置或地理哈希查询GPS可信度等级
• 元数据 (2种工具) - 字段和实体元数据查询
• 坐标转换 （2种工具）- 在LLH坐标系和ECEF坐标系之间进行转换

测试

测试代理是否正常工作：

export GPSTRUST_API_KEY="your-api-key-here"
uv run gt-mcp-proxy

代理程序应启动并等待在标准输入（stdin）上接收MCP协议消息（按Ctrl+C退出）。

故障排除

工具未出现在Claude桌面版中

1. 检查绝对路径 你的配置是正确的
2. 重启Claude桌面版 在做出配置更改后
3. 查看日志帮助 → 在Claude桌面菜单中查看日志

“未提供API密钥”错误

确保 GPSTRUST_API_KEY 环境变量在配置文件中已设置。

连接错误

测试服务器是否可访问：

curl -H "x-api-key: your-api-key" https://gt.aussierobots.com.au/mcp

如果此操作失败，请检查：

• 您的API密钥是有效的
• 你已连接到互联网
• GPS信任服务器正在运行

它是如何工作的

┌─────────────────┐
│ Claude Desktop  │
│ or Claude Code  │
└────────┬────────┘
         │ stdio
         ▼
┌─────────────────┐
│  GPS Trust MCP  │
│     Proxy       │
│  (This Repo)    │
└────────┬────────┘
         │ HTTP + x-api-key
         ▼
┌─────────────────┐
│  GPS Trust MCP  │
│     Server      │
│  (AWS Lambda)   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│    DynamoDB     │
│  (Device Data)  │
└─────────────────┘

代理：

1. 通过stdio传输连接到Claude Desktop/Code
2. 通过HTTP将MCP请求转发给远程GPS信任服务器
3. 注入您的API密钥以进行身份验证
4. 将响应反馈给克劳德

支持

如需解决任何问题或咨询任何事项，请联系您的GPS Trust管理员。

许可证

看 许可证