Fatebook MCP

🚀 Fatebook MCP Server

予測追跡プラットフォームであるFatebookとの統合を提供する、モデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、ClaudeのようなAIアシスタントがMCPを介して予測の作成、管理、追跡を直接行うことができます。

✨ 主な機能

• 質問の作成：予測（0 - 100%の確率）を伴う予測を行います。
• 質問の一覧表示：フィルタオプションを使用して予測を表示します。
• 質問の詳細取得：特定の質問に関する包括的な情報を取得します。
• 予測の追加：既存の質問に対する予測確率を更新します。
• コメントの追加：理由を追跡するためのコメントを追加します。
• 質問の解決：質問を解決済み（YES/NO/AMBIGUOUS）としてマークします。
• 質問の編集：質問のタイトル、解決日、メモを更新します。
• 質問の削除：不要になった質問を削除します。
• 予測のカウント：予測活動を追跡します。

📦 インストール

前提条件

• Python 3.13以上
• uv（推奨）またはpip
• FatebookアカウントとAPIキー

Fatebook APIキーの取得

1. Fatebookにサインインします。
2. APIセットアップに移動します。
3. APIキーを生成してコピーします。

オプション1：PyPIからインストール（推奨）

PyPIから直接パッケージをインストールします。

pip install fatebook-mcp

またはuvを使用して：

uv add fatebook-mcp

オプション2：ソースからインストール

開発用または最新機能を使用する場合：

1. リポジトリをクローンします。

git clone https://github.com/an1lam/fatebook-mcp.git
cd fatebook-mcp

2. uvを使用して依存関係をインストールします。

uv sync

🚀 クイックスタート

uvxで直接実行する

インストール後にサーバーをテストする最も簡単な方法は、uvxを使用することです。

# PyPIから直接実行（インストール不要）
uvx fatebook-mcp

# または開発中にローカルディレクトリから実行
uvx --from . fatebook-mcp

サーバーが起動し、stdioを介したMCPクライアント接続を待機します。Ctrl+Cで停止します。

💻 使用例

基本的な使用法

Claude DesktopおよびClaude Codeでの使用方法を説明します。

Claude Desktop

Claude Desktopの設定ファイルに以下の設定のいずれかを追加します。

macOS

場所: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

場所: %APPDATA%\Claude\claude_desktop_config.json

オプション1：PyPIパッケージを使用する（推奨）

{
  "mcpServers": {
    "fatebook": {
      "command": "uvx",
      "args": ["fatebook-mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

注意: Claude Desktopがuvxを見つけられない場合は、完全なパスを使用してください。

{
  "mcpServers": {
    "fatebook": {
      "command": "/Users/yourusername/.local/bin/uvx",
      "args": ["fatebook-mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

uvxのパスはwhich uvxで確認できます。

オプション2：開発/ソースからのインストール

{
  "mcpServers": {
    "fatebook": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/fatebook-mcp",
        "run",
        "python",
        "-m",
        "fatebook_mcp"
      ],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

/path/to/fatebook-mcpをこのリポジトリをクローンした実際のパスに置き換えてください。

Claude Code (CLI)

Claude Codeでは、このサーバーをいくつかの方法で追加できます。

オプション1：PyPIパッケージを使用する（推奨）

# uvxを使用してFatebook MCPサーバーを追加
claude mcp add fatebook --env FATEBOOK_API_KEY=your-api-key-here -- uvx fatebook-mcp

# 追加が成功したことを確認
claude mcp list

オプション2：Claude Desktopからインポートする

Claude Desktopですでにこの設定を行っている場合は、その設定をインポートできます。

claude mcp add-from-claude-desktop

オプション3：プロジェクト固有の設定

プロジェクトに.mcp.jsonファイルを作成します。

PyPIパッケージを使用する場合

{
  "mcpServers": {
    "fatebook": {
      "command": "uvx",
      "args": ["fatebook-mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

uvxが見つからない場合は、完全なパスを使用してください（which uvxで確認）。

{
  "mcpServers": {
    "fatebook": {
      "command": "/Users/yourusername/.local/bin/uvx",
      "args": ["fatebook-mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

開発/ソースからのインストールを使用する場合

{
  "mcpServers": {
    "fatebook": {
      "command": "uv",
      "args": ["--directory", "/path/to/fatebook-mcp", "run", "python", "-m", "fatebook_mcp"],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

/path/to/fatebook-mcpをこのリポジトリをクローンした実際のパスに置き換えてください。

テストと互換性

このMCPサーバーは、以下の環境でテストされています。

• Claude Code (CLI)
• Claude Desktop
• MCP Inspector

MCPは進化するプロトコルであるため、特定の機能やMCPクライアントが完全にサポートされていない場合があります。他のMCP実装で問題が発生した場合は、GitHubのissueとして報告してください。

トラブルシューティング

uvxコマンドが見つからない場合

Claude Desktopがuvxに関する「コマンドが見つからない」エラーを表示する場合：

1. uvxのパスを見つける

which uvx

2. 設定で完全なパスを使用する

"command": "/Users/yourusername/.local/bin/uvx"

3. 一般的なuvxの場所
   • macOS: /Users/yourusername/.local/bin/uvx
   • Linux: /home/yourusername/.local/bin/uvx

APIキーの問題

• APIキーが有効でアクティブであることを確認してください。
• APIキーが環境変数または設定に正しく設定されていることを確認してください。
• リクエストで直接APIキーを提供することを試してください。

接続の問題

• Claude Desktopの設定でサーバーのパスが正しいことを確認してください。
• Python 3.13以上がインストールされており、アクセス可能であることを確認してください。
• uv syncでuvの依存関係が正しくインストールされていることを確認してください。

質問の形式

• 日付はYYYY-MM-DD形式である必要があります。
• 予測値は0.0から1.0の間である必要があります。
• 質問IDは質問を作成する際に提供されます。

開発とテスト

追加設定

MCPサーバーを使用するために必要な上記の設定に加えて、MCPサーバーをスタンドアロンで実行したり、テストを実行したりするには、APIキーを取得して環境にエクスポートする必要があります。 これは、直接エクスポートするか、.envファイルを作成することで行うことができます。

export FATEBOOK_API_KEY="your-api-key-here"

または.envファイルを作成します。

FATEBOOK_API_KEY=your-api-key-here

統合テストの実行

設定を検証するために統合テストを実行します。

uv run pytest test_client.py

これにより、すべての利用可能なエンドポイントがテストされ、サーバーが正常に動作していることが確認されます。 注意: これらのテストは、テストユーザーの正しいAPIキーを持っている場合にのみ成功します。これらのテストを実行する必要がある場合は、現時点では著者にメールを送ってください。

サーバーをローカルで実行する

uvxを使用する（推奨）

uvx --from . fatebook-mcp

uv runを使用してモジュールで実行する

uv run python -m fatebook_mcp

サーバーが起動し、MCPクライアント接続を待機します。

例

Claude Desktop

予測の作成と追跡

予測のレビュー

Claude Code

📚 ドキュメント

Fatebook APIの詳細については、以下を参照してください。

• Fatebook APIセットアップ
• OpenAPI仕様

貢献

貢献は大歓迎です！issueやプルリクエストを自由に提出してください。

サポート

以下の問題に関しては：

• このMCPサーバー：GitHubでissueを作成してください。
• Fatebook API：Fatebookサポートに問い合わせてください。
• MCP/Claude Desktop：MCPドキュメントを参照してください。