Futuur MCP

🚀 Futuur API MCP 集成

Futuur API MCP 集成项目基于 TypeScript 构建了强大服务器，实现模型上下文协议 (MCP)，可与 Futuur API 无缝集成。它提供了全面接口，用于处理市场数据、类别、用户信息和投注操作。

🚀 快速开始

先决条件

• Node.js（推荐使用最新 LTS 版本）
• npm 或 yarn 包管理器

安装步骤

1. 克隆仓库：

git clone https://github.com/yourusername/futuur-api-mcp.git
cd futuur-api-mcp

2. 安装依赖项：

npm install

集成步骤

要将 MCP 服务器与 Cursor 集成，请按照以下步骤操作：

1. 编译项目：

npm run build

2. 使用 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 仓库中打开一个问题，或联系开发团队寻求帮助。