返回 MCP 目录
public公开dns本地运行

Futuur-MCP

Futuur API MCP集成是一个基于TypeScript的服务器项目,实现了模型上下文协议(MCP),用于与Futuur API无缝集成。该项目提供市场数据、类别管理、用户信息和投注操作等强大接口,采用模块化工具架构,包含全面的文档资源。

article

README

🚀 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
  1. 安装依赖项:
npm install

集成步骤

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

  1. 编译项目:
npm run build
  1. 使用 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 团队 ❤️ 打造
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端