位置证明查询服务

星光api mcp

MCP（模型上下文协议）服务器，使AI模型能够使用可用的Astral GraphQL端点和API查询位置证明。

目录

• 星光api mcp
  • 项目概述
  • 与召回平台集成
  • 快速开始
    • 先决条件
    • 安装
    • 可用代理工具
    • 测试MCP服务器
    • 测试
    • 发展
    • 故障排除

项目概述

我们正在探索开发一种模型上下文协议（MCP）代理，该代理与 阿斯特拉尔API 以实现对提交给以太坊认证服务（EAS）等区块链生态系统的证明的智能查询和分析。此代理将支持跨空间和时间维度的复杂查询，例如按模式ID、位置或日期范围过滤证明，同时跨会话维护持久上下文。通过利用Astral的结构化API和EAS的开放式模式模型，代理可以自动化常见的分析工作流程，如生成证明热图或跟踪模式随时间的使用，使其成为研究和生产用例的宝贵工具。这一早期范围界定阶段将有助于评估可行性，并确定这一方向是否值得进一步投资。

要了解更多信息，请参阅以下内容 文件 有关目的、用例、架构和开发计划的更多详细信息。

与召回平台集成

召回 是一个基于区块链的平台，支持链上存储原语和代理协作工具的持久智能代理，使AI代理能够维护持久内存，在会话之间共享数据，并参与更广泛的互联代理生态系统。通过将Astral MCP代理与Recall集成，我们可以将其从独立的位置证明查询工具转换为具有长期记忆的代理网络中的协作参与者，使其能够在链上存储空间分析见解，构建随时间变化的位置模式的知识图，并与生态系统中的其他代理共享地理空间情报。这种集成释放了强大的功能，如持久会话上下文、跨代理位置验证服务，以及为社区驱动的位置智能做出贡献的能力，将您的代理定位为不断增长的人工智能代理网络中有价值的空间数据的消费者和提供者，这些代理可以从彼此的发现中学习并建立在彼此的发现之上。

一旦Astral MCP代理正常工作，我们计划将其与Recall平台集成，通过在链上存储洞察来实现持久内存。您可以了解有关下一阶段开发的更多详细信息 在下一节中.

快速开始

先决条件

• Python 3.12+（用Python 3.13测试）
• 依赖管理诗

安装

1. 克隆存储库：

git clone <repository-url>
cd astral-api-mcp

2. 使用Poetry安装依赖项：

poetry install

3. 验证安装：

poetry run python -c "import astral_mcp_server; print('Installation successful!')"

4. 测试API连接：

poetry run python -c "import asyncio; from astral_mcp_server.server import check_astral_api_health; print('Health check:', asyncio.run(check_astral_api_health())['status'])"

配置

选择API端点:

MCP服务器可以配置为使用生产或开发Astral API端点：

1. 通过环境变量 （最高优先级）：

   复制

   export ASTRAL_USE_DEV_ENDPOINT=true
   poetry run start-server
   

2. 通过MCP配置 (.vscode/mcp.json):

   复制

   {
     "servers": {
       "astral-api": {
         "command": "poetry",
         "args": ["run", "start-server"],
         "cwd": "${workspaceFolder}",
         "type": "stdio"
       }
     },
     "mcp_agent": {
       "use_dev_endpoint": true,
       "dev_endpoint": "https://custom-dev-api.example.com"
     }
   }
   

配置选项:

• use_dev_endpoint：设置为 true 使用API开发端点
• dev_endpoint （可选）：用自定义URL覆盖默认的开发端点URL

服务器将在启动时自动选择适当的端点，并记录正在使用的端点。

可用代理工具

• check_astral_api_health：验证与Astral API的连接
• get_server_info：获取有关MCP服务器实例的信息
• query_location_proofs：通过各种过滤器（链、证明器、模式ID等）查询位置证明
• get_location_proof_by_uid：通过其唯一标识符检索特定的位置证明证明
• get_astral_config：获取Astral API配置和支持的链

了解更多关于可用工具以及如何在 MCP工具指南.

测试MCP服务器

重要：MCP服务器不作为web服务器运行，它们通过MCP协议进行通信。

使用MCP检查器进行测试（交互式调试）:

poetry run mcp dev astral_mcp_server/server.py

或者，您可以从以下位置启动MCP检查器 mcp.json 通过VSCode中的UI。

这将打开 MCP检查器工具 在浏览器中，您可以：

• 查看可用工具(check_astral_api_health, get_server_info)
• 交互式执行工具
• 查看工具输出并调试

这 .env mcp检查员 文件设置MCP检查器用于连接到MCP服务器的环境变量。如果需要，您可以对其进行修改。

与Claude Desktop或其他MCP客户端一起使用:

以下配置允许您将MCP服务器与Claude Desktop或VSCode MCP扩展等客户端连接。

Claude Desktop的配置：

{
  "mcpServers": {
    "astral-api": {
      "command": "poetry",
      "args": ["run", "start-server"],
      "cwd": "/path/to/astral-api-mcp" // the local path to cloned astral-api-mcp repo
    }
  }
}

VSCode MCP扩展的配置：

{
  "servers": {
    "astral-api": {
      "command": "poetry",
      "args": ["run", "start-server"],
      "cwd": "${workspaceFolder}" // or the local path to cloned astral-api-mcp repo
    }
  }
}

配置后，您可以从客户端连接到MCP服务器（即GitHub Copilot Chat in agent 模式）并开始使用可用工具。

测试

运行测试套件：

poetry run pytest tests/ -v

发展

本项目使用：

• 诗歌 用于依赖关系管理
• FastMCP MCP服务器实现框架
• httpx 用于向Astral API发送HTTP请求
• pytest 用于测试

故障排除

如果你遇到任何 PORT IS IN USE 运行MCP检查器时出错，例如：

[警告][服务器错误]❌ MCP检查端口正在使用中http://localhost:8881 ❌

MCP检查器可能已经在另一个终端或进程中运行，或者端口被需要停止的另一个服务占用。如果MCP检查器没有运行，它可能没有完全退出，留下一个孤立的进程，即。 node.exe 仍然持有端口。如果是这样的话，您可以尝试运行 免费mcp端口 找到脚本 这里.