article
README
🚀 Futuur API MCP 集成
Futuur API MCP 集成项目基于 TypeScript 构建了强大服务器,实现模型上下文协议 (MCP),可与 Futuur API 无缝集成。它提供了全面接口,用于处理市场数据、类别、用户信息和投注操作。
🚀 快速开始
先决条件
- Node.js(推荐使用最新 LTS 版本)
- npm 或 yarn 包管理器
安装步骤
- 克隆仓库:
git clone https://github.com/yourusername/futuur-api-mcp.git
cd futuur-api-mcp
- 安装依赖项:
npm install
集成步骤
要将 MCP 服务器与 Cursor 集成,请按照以下步骤操作:
- 编译项目:
npm run build
- 使用 Cursor 运行 MCP 服务器:
Windows 操作系统:
cmd /c npx mcprunner FUTUUR_PUBLIC_KEY=*YOUR_FUTUUR_PUBLIC_KEY* FUTUUR_PRIVATE_KEY=*YOUR_FUTUUR_PRIVATE_KEY* -- node C:/webapps/futuur-api-mcp/build/index.js
macOS/Linux 操作系统:
npx mcprunner FUTUUR_PUBLIC_KEY=*YOUR_FUTUUR_PUBLIC_KEY* FUTUUR_PRIVATE_KEY=*YOUR_FUTUUR_PRIVATE_KEY* -- node C:/webapps/futuur-api-mcp/build/index.js
请将 *YOUR_FUTUUR_PUBLIC_KEY* 和 *YOUR_FUTUUR_PRIVATE_KEY* 替换为您实际的 Futuur API 凭证。
✨ 主要特性
- 🔄 实时市场数据集成
- 📊 类别管理
- 👤 用户资料处理
- 🎲 投注操作
- 📚 丰富的文档资源
- 🛠️ 模块化工具架构
📚 详细文档
项目结构
futuur-api-mcp/
├── src/
│ ├── tools/ # 工具实现目录
│ ├── utils/ # 辅助函数目录
│ └── index.ts # 服务器入口文件
├── build/ # 编译后的 JavaScript 输出
├── package.json # 项目依赖管理
├── package-lock.json # 依赖锁定文件
├── tsconfig.json # TypeScript 配置文件
└── .env # 环境变量配置
核心组件
- Market Tools:处理市场相关操作
- Category Tools:管理类别数据和操作
- User Tools:处理用户相关功能
- Bet Tools:处理投注操作
开发信息
该项目使用 TypeScript 以确保类型安全和更好的开发体验。服务器通过官方 MCP SDK 实现了模型上下文协议 (MCP)。
调试模式
服务器包含一个可切换的调试模式,通过设置 index.ts 中的 DEBUG 常量即可启用或禁用。启用后,将提供详细的日志信息。
依赖管理
@modelcontextprotocol/sdk:核心 MCP 实现zod:运行时类型检查和验证
📄 许可证
ISC
👥 贡献与支持
贡献指南
欢迎贡献!请随意提交 Pull Request。
支持信息
如需支持,请在 GitHub 仓库中打开一个问题,或联系开发团队寻求帮助。
由 Futuur 团队 ❤️ 打造
微信扫一扫