Limitless MCP Server

Limitless MCP Server

⚠️ 注意：Quantish 即将停止运营。 Quantish 平台（quantish.live）即将关闭。此 MCP 服务可自托管，并将继续独立运行，但 Quantish 团队将不再维护或更新此项目。如果你正在预测市场领域构建项目，并需要实时数据基础设施，请访问 polynode.dev。

功能

• 安全的钱包管理

  • 生成新的 Base 钱包，并加密存储私钥
  • 自带钱包（BYOW）——导入现有钱包，并使用客户端加密
  • 存储前使用 AES-256-GCM 加密私钥

• 全面访问 Limitless 市场

  • 通过 Limitless Exchange API 实时发现市场
  • 访问所有预测市场：政治、体育、加密货币等
  • 实时订单簿数据和价格历史
  • 使用语义搜索发现市场

• 交易操作

  • 使用 EIP-712 签名认证提交限价订单
  • 撤销订单（单笔、批量或全部）
  • 检查并设置代币授权（USDC、CTF）
  • 追踪仓位并计算盈亏

• AI Agent 集成

  • 全面支持 MCP（Model Context Protocol）
  • 兼容 Claude、Cursor IDE 和其他支持 MCP 的 AI 工具
  • 提供 34 个按类别整理的预构建交易工具

• 企业级安全

  • 使用 AES-256-GCM 加密所有敏感数据
  • 使用 SHA-256 哈希进行 API 密钥认证
  • 为 B2B 集成提供平台合作伙伴系统
  • 速率限制和请求日志记录

快速开始

1. 配置 MCP（Cursor IDE）

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "limitless": {
      "url": "https://limitless-mcp-server-production.up.railway.app/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

2. 获取 API 密钥

通过 MCP 工具：

{
  "tool": "limitless_signup",
  "args": {
    "externalId": "your-unique-id"
  }
}

3. 开始交易

"Search for bitcoin prediction markets"
"Buy 10 YES shares at $0.60 on the BTC market"
"Show my current positions"
"Cancel my open orders"

可用的 MCP 工具（共 34 个）

注意： 所有工具名称均以 limitless_ 为前缀，以避免与其他 MCP 冲突。

身份验证与设置（6 个工具）

钱包信息（4 个工具）

市场发现（6 个工具）

交易（8 个工具）

持仓（4 个工具）

转账（3 个工具）

API 密钥管理（3 个工具）

自托管

前提条件

• Node.js 20+
• PostgreSQL 15+
• Base RPC 访问权限（mainnet.base.org）

安装

# Clone the repository
git clone https://github.com/joinQuantish/limitless-mcp.git
cd limitless-mcp

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Edit .env with your values (see Environment Variables below)

# Generate Prisma client
npx prisma generate

# Push database schema
npx prisma db push

# Build and start
npm run build
npm start

环境变量

创建一个 .env 文件，内容如下：

# Database (PostgreSQL)
DATABASE_URL="postgresql://user:password@host:5432/limitless_mcp?schema=public"

# Encryption (generate with: openssl rand -hex 32)
ENCRYPTION_KEY="your-64-character-hex-encryption-key-here"

# Blockchain - Base L2
BASE_RPC_URL="https://mainnet.base.org"

# Limitless Exchange API
LIMITLESS_API_URL="https://api.limitless.exchange"

# Server
PORT=3003
NODE_ENV=production

# Admin API Key (generate with: openssl rand -hex 32)
ADMIN_API_KEY="your-admin-api-key-here"

# Optional: Bot signing secret for returning user verification
BOT_SIGNING_SECRET=""

Docker 部署

# Build the image
docker build -t limitless-mcp .

# Run the container
docker run -d \
  -p 3003:3003 \
  -e DATABASE_URL="postgresql://..." \
  -e ENCRYPTION_KEY="..." \
  -e ADMIN_API_KEY="..." \
  -e BASE_RPC_URL="https://mainnet.base.org" \
  -e LIMITLESS_API_URL="https://api.limitless.exchange" \
  -e NODE_ENV=production \
  limitless-mcp

Railway 部署

# Install Railway CLI
npm install -g @railway/cli

# Login and initialize
railway login
railway init

# Add PostgreSQL via Railway dashboard

# Set environment variables
railway variables set DATABASE_URL="postgresql://..."
railway variables set ENCRYPTION_KEY="$(openssl rand -hex 32)"
railway variables set ADMIN_API_KEY="$(openssl rand -hex 32)"
railway variables set BASE_RPC_URL="https://mainnet.base.org"
railway variables set LIMITLESS_API_URL="https://api.limitless.exchange"
railway variables set NODE_ENV="production"

# Deploy
railway up

API 参考

健康检查

curl https://your-server/health

响应：

{
  "status": "healthy",
  "timestamp": "2026-01-17T12:00:00.000Z",
  "version": "1.0.0",
  "service": "limitless-mcp",
  "database": "connected",
  "environment": "production"
}

MCP 端点

# List available tools
curl -X POST https://your-server/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Call a tool (authenticated)
curl -X POST https://your-server/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_limitless_..." \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/call",
    "params":{
      "name":"limitless_get_balances",
      "arguments":{}
    }
  }'

市场数据 API

# Get active markets
curl "https://your-server/api/markets?limit=10&page=1"

# Search markets
curl "https://your-server/api/markets/search?query=bitcoin&limit=5"

# Get market details
curl "https://your-server/api/markets/your-market-slug"

# Get orderbook
curl "https://your-server/api/markets/your-market-slug/orderbook"

安全架构

API Key Format: pk_limitless_<32 base64url chars>
API Secret Format: sk_limitless_<43 base64url chars>

安全导入钱包（BYOW）

安全导入现有的 MetaMask/硬件钱包：

第 1 步：导出私钥

在 MetaMask 中：Settings > Security > Export Private Key

第 2 步：在本地加密

const crypto = require('crypto');

const privateKey = 'YOUR_PRIVATE_KEY_WITHOUT_0x_PREFIX';
const password = 'YourSecurePassword123!'; // min 12 chars

const salt = crypto.randomBytes(32);
const iv = crypto.randomBytes(16);
const derivedKey = crypto.scryptSync(password, salt, 32, { N: 16384, r: 8, p: 1 });

const cipher = crypto.createCipheriv('aes-256-gcm', derivedKey, iv);
let encrypted = cipher.update(privateKey, 'utf8', 'hex');
encrypted += cipher.final('hex');
const authTag = cipher.getAuthTag().toString('hex');

console.log({
  encryptedKey: `${encrypted}:${authTag}`,
  salt: salt.toString('hex'),
  iv: iv.toString('hex'),
  publicKey: 'YOUR_WALLET_ADDRESS'
});

第 3 步：导入 SDK

{
  "tool": "limitless_import_wallet",
  "args": {
    "encryptedKey": "...",
    "salt": "...",
    "iv": "...",
    "publicKey": "0x...",
    "password": "YourSecurePassword123!"
  }
}

安全提示：原始私钥绝不会离开你的设备。只有加密后的数据包会发送到我们的服务器；没有你的密码，我们无法解密。

相关资源

许可证

PolyForm Noncommercial 1.0.0 © Quantish

支持

• 问题反馈：GitHub Issues
• 电子邮件：[email protected]