AI导哈

交易协议服务器

Extended Exchange MCP服务器实现，用于AI助手与Starknet上的永续交易平台交互，提供实时市场数据、账户管理、投资组合监控和交易操作功能。

  • by Akashneelesh
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Akashneelesh/extended-mcp

使用说明

扩展Exchange MCP服务器

模型上下文协议（MCP）服务器实现 扩展交换 -使Claude Desktop等人工智能助手能够与Extended在Starknet上的永久交易平台进行交互。

这是什么？

此存储库包含 MCP服务器实现 扩展交换。它使Claude Desktop和其他兼容MCP的AI助手能够：

  • 📊 访问实时市场数据（价格、订单簿、蜡烛）
  • 💼 管理交易账户和投资组合
  • 📈 查看头寸、余额和未结订单
  • 🔄 下达和取消限价订单
  • 🌐 同时适用于测试网和主网环境

快速开始

先决条件

  • Python 3.10或更高版本
  • 紫外线 （推荐）或pip

安装

步骤1：安装扩展Python SDK

MCP服务器需要扩展Python SDK才能运行：

pip install "x10-python-trading-starknet[mcp]"

这将安装：

  • 完整的扩展Python SDK
  • 所有MCP依赖项
  • 这 x10-mcp 命令行工具

步骤2：验证安装

x10-mcp --help

步骤3：为Claude Desktop进行配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "x10": {
      "command": "x10-mcp",
      "args": ["--environment", "testnet"],
      "env": {}
    }
  }
}

步骤4:重新启动克劳德桌面

看 详细文件 用于身份验证设置、所有可用工具和高级配置。

特性

公开市场数据（无需授权）

  • 列出所有可用市场
  • 获取市场统计数据和24小时数据
  • 获取实时订单簿
  • 历史蜡烛/OHLCV数据

帐户管理（需要授权）

  • 列出并激活交易账户
  • 查看帐户详细信息和概述
  • 从L1私钥自动导出斯塔克密钥

投资组合监控（需要授权）

  • 实时账户余额
  • PnL的空缺职位
  • 主动订单跟踪

交易操作（需要授权）

  • 下达限价订单（买入/卖出）
  • 按ID或外部ID取消订单
  • 仅发布和减少仅订单支持

文档

建筑

┌─────────────────┐
│ Claude Desktop  │
│   (MCP Client)  │
└────────┬────────┘
         │ MCP Protocol (stdio)
         │
┌────────▼────────┐
│  x10-mcp Server │  ← This Repository
│   (FastMCP)     │
└────────┬────────┘
         │
┌────────▼────────┐
│ Extended Python │  ← Installed from PyPI
│      SDK        │
└────────┬────────┘
         │ HTTPS/WSS
         │
┌────────▼────────┐
│ Extended API    │
│   (Starknet)    │
└─────────────────┘

存储库结构

extended-mcp/
├── README.md                    # This file
├── mcp/
│   ├── README.md               # Detailed documentation
│   ├── AUTHENTICATION.md       # Auth setup guide
│   ├── __init__.py            # Package initialization
│   ├── cli.py                 # Command-line interface
│   ├── server.py              # FastMCP server implementation
│   └── state.py               # State management & API calls

Claude Desktop中的示例用法

配置后，您可以通过自然语言与Extended Exchange交互：

市场数据：

  • “显示Extended testnet上的所有可用市场”
  • “目前BTC-USD的价格和订单深度是多少？”
  • “在过去的24小时里，给我买1小时的ETH-USD蜡烛”

账户和投资组合：

  • “列出我的扩展Exchange帐户”
  • “我目前的余额和未结头寸是多少？”
  • “显示我所有的未结订单”

交易：

  • “以95000美元的价格下0.1 BTC的限价买入订单”
  • “取消我对ETH-USD的所有未结订单”

入门指南

对于测试网：

  1. 访问 扩展测试网
  2. 连接您的钱包并创建帐户
  3. 申请1000美元测试USDC（免费！）
  4. 从获取您的API证书 API管理
  5. 使用您的凭据配置Claude Desktop

对于主网：

  1. 访问 扩展主网
  2. 从获取凭据 API管理
  3. 使用主网凭据配置Claude Desktop

看 完整指南 有关详细的设置说明。

环境变量

变量 描述 必填
X10_MCP_ENVIRONMENT testnet 或 mainnet 否（默认：testnet）
X10_MCP_STARK_VAULT 保险库编号 用于交易
X10_MCP_STARK_PRIVATE_KEY 斯塔克私钥 用于交易
X10_MCP_STARK_PUBLIC_KEY 斯塔克公钥 用于交易
X10_MCP_API_KEY 扩展API密钥 用于交易
X10_MCP_L1_PRIVATE_KEY 以太坊私钥（替代身份验证） 用于交易

安全最佳实践

  • ⚠️ 从不提交私钥 到版本控制
  • 🔐 使用环境变量作为凭据
  • 🔄 定期旋转API键
  • 🧪 在主网之前在测试网上进行测试
  • 💰 从主网上的小额开始

贡献

欢迎投稿！请随时提交问题或拉取请求。

链接

  • 扩展交换: https://extended.exchange
  • API文档: https://api.docs.extended.exchange
  • 测试网: https://starknet.sepolia.extended.exchange/perp
  • 主网: https://app.extended.exchange/perp
  • Discord 的中文翻译是“不和谐”或“纷争”。: 扩展社区
  • MCP规范: https://modelcontextprotocol.io

许可证

MIT许可证-有关详细信息，请参阅许可证文件

支持

  • GitHub 问题: https://github.com/Akashneelesh/extended-mcp/issues
  • Discord 的中文翻译是“不和谐”或“纷争”。: 扩展Exchange不一致
  • 文档: https://api.docs.extended.exchange

内置❤️ 对于扩展Exchange社区

相关 MCP