Allora MCP 服务器

这是一个模型上下文协议 (MCP) 服务器的实现，用于从 Allora 网络获取机器学习推断，通过模型上下文协议提供对 Allora 预测市场数据的访问。

概述

Allora MCP 服务器允许 AI 系统和应用程序通过标准化的模型上下文协议 (MCP) 访问 Allora 预测市场数据，从而实现预测市场数据与 AI 工作流程的无缝集成。 该服务器提供对 Allora 主题、市场预测和推断数据的直接访问。

前提条件

• Node.js 18 或更高版本
• 一个 Allora API 密钥（在 alloralabs.com 注册）

设置

1. 克隆存储库

git clone https://github.com/your-username/allora-mcp.git
cd allora-mcp

2. 安装依赖项

npm install

3. 设置环境变量

在项目根目录中创建一个 .env 文件（或从 .env.example 复制）：

PORT=3001
ALLORA_API_KEY=your_api_key

开发

npm run dev

构建

npm run build

运行

npm start

Docker

构建 Docker 镜像

docker build -t allora-mcp .

使用 Docker 运行

# 运行容器
docker run -p 3001:3001 -e PORT=3001 -e ALLORA_API_KEY=your_api_key allora-mcp

# 或者使用文件中的环境变量
docker run -p 3001:3001 --env-file .env allora-mcp

Docker Compose (可选)

创建一个 docker-compose.yml 文件：

version: '3'
services:
  allora-mcp:
    build: .
    ports:
      - "3001:3001"
    environment:
      - PORT=3001
      - ALLORA_API_KEY=your_api_key

然后运行：

docker-compose up

API 使用

服务器运行后，您可以使用任何 MCP 客户端与其交互。 该服务器公开以下端点：

• GET /sse - 用于 MCP 通信的 SSE 连接端点
• POST /messages - 用于 MCP 通信的消息端点

可用工具

工具名称	描述	参数
list_all_topics	获取所有 Allora 主题的列表	无
get_inference_by_topic_id	获取特定主题的推断数据	topicID: 数字

与 Claude 的示例用法

当连接到 Claude 或其他 MCP 兼容的 AI 系统时，您可以使用以下方式访问 Allora 数据：

Allora 中有哪些主题可用？

或者获取特定的推断数据：

8 小时后 BTC 价格的当前预测是什么？

贡献

欢迎贡献！ 请随时提交 Pull Request。

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。