Futuur MCP

🚀 Futuur API MCP 集成

Futuur API MCP 集成は、TypeScript をベースとした強力なサーバーで、モデルコンテキストプロトコル (MCP) を実装し、Futuur API とのシームレスな統合を実現します。このプロジェクトは、市場データ、カテゴリ、ユーザー情報、およびベット操作を処理するための包括的なインターフェースを提供します。

🚀 クイックスタート

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

📚 ドキュメント

プロジェクト構造

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：ランタイム型チェックと検証

統合手順

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 資格情報に置き換えてください。

📄 ライセンス

ISC

貢献ガイド

貢献を歓迎します！自由に Pull Request を送信してください。

サポート情報

サポートが必要な場合は、GitHub リポジトリで問題を開くか、開発チームに連絡して支援を求めてください。