扩展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 callsClaude Desktop中的示例用法
配置后，您可以通过自然语言与Extended Exchange交互：
市场数据：
- “显示Extended testnet上的所有可用市场”
- “目前BTC-USD的价格和订单深度是多少？”
- “在过去的24小时里，给我买1小时的ETH-USD蜡烛”
账户和投资组合：
- “列出我的扩展Exchange帐户”
- “我目前的余额和未结头寸是多少？”
- “显示我所有的未结订单”
交易：
- “以95000美元的价格下0.1 BTC的限价买入订单”
- “取消我对ETH-USD的所有未结订单”
入门指南
对于测试网：
对于主网：
看 完整指南 有关详细的设置说明。
环境变量
| 变量 | 描述 | 必填 |
|---|---|---|
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社区