# Multi-Agent Thinking MCP Server

このプロジェクトは、複雑なタスクに対して複数の視点やアプローチを並列に検討・実行するための MCP (Multi-Component Protocol) サーバーです。内部的に複数のエージェント（スペシャリストエージェント）を生成し、それぞれの専門分野に基づいてタスクを分担・実行させることで、より深く、多角的な分析や解決策の生成を目指します。

このプロジェクトは HuggingFace の `smolagents` ライブラリと FastMCP を基盤としています。

## 主な機能

-   **マルチエージェント思考:**
    -   単一のタスク記述から、複数の異なる視点やアプローチを自動生成します。
    -   各アプローチを専門とするスペシャリストエージェントを並列に実行します。
    -   視点分担型、タスク分担型、段階分担型、並列解法型、分岐探索型、分解再構築型など、多様な問題解決戦略をサポートします。
    -   各スペシャリストからの報告を統合し、最終的な結論や解決策を提示します。
-   **MCP サーバー:**
    -   `fastmcp` を使用して、MCP サーバーとして機能します。
    -   Cursor IDE などの MCP クライアントから `multiagent.multiagent_thinking` ツールとして呼び出すことができます。

## 要件

-   Python 3.11 以降
-   `uv` パッケージマネージャー
-   以下の API キー:
    -   OpenAI API キー (`OPENAI_API_KEY`)
    -   HuggingFace トークン (`HF_TOKEN`)

## インストール

1.  リポジトリをクローンします:
    ```bash
    git clone https://github.com/Hajime-Y/multiagents-thinking.git
    cd multiagents-thinking
    ```

2.  仮想環境を作成し、依存関係をインストールします:
    ```bash
    uv venv
    source .venv/bin/activate # Linux/macOS の場合
    # .venv\Scripts\activate # Windows の場合
    uv sync
    ```
    (依存関係は `pyproject.toml` で管理されています)

## 環境変数

プロジェクトのルートディレクトリに `.env` ファイルを作成し、以下の環境変数を設定してください:

```dotenv
OPENAI_API_KEY=your_openai_api_key
HF_TOKEN=your_huggingface_token
```

## 使い方

MCP サーバーを起動します:

```bash
uv run python -m src.multiagents
```

これにより、`multiagent` という名前のエージェント (MCP サーバー) が起動します。MCP クライアント (Cursor IDE など) から `multiagent.multiagent_thinking` ツールを呼び出すことで、マルチエージェント思考プロセスを実行できます。

**例 (Cursor IDE での呼び出し):**

```
@multiagent.multiagent_thinking 新しいオンライン教育プラットフォームの設計方針について、学習科学、データ駆動、社会的学習の3つの観点から分析し、具体的なアイデアを提案してください。
```

### Claude Desktop での使用

Claude Desktop でこの MCP サーバーを使用するには、設定ファイル（通常 `~/.config/Claude/claude_desktop_config.json` 等）に以下のような設定を追加します。

```json
{
  "mcpServers": {
    "multiagent": {
      "command": "/PATH/TO/YOUR/uv", // あなたの環境の uv への絶対パス
      "args": [
        "--directory",
        "/YOUR/ABSOLUTE/PATH/TO/multiagents-thinking", // このプロジェクトディレクトリへの絶対パス
        "run",
        "python",
        "-m",
        "src.multiagents"
      ]
    }
  }
}
```

- `/PATH/TO/YOUR/uv` は、`uv` 実行ファイルの絶対パスに置き換えてください (`which uv` コマンド等で確認できます)。
- `/YOUR/ABSOLUTE/PATH/TO/multiagents-thinking` は、このプロジェクト (`multiagents-thinking` ディレクトリ) の絶対パスに置き換えてください。

## 主要コンポーネント

-   `src/multiagents.py`: MCP サーバーのエントリーポイント。`multiagent_thinking` ツールを定義。
-   `src/create_agent.py`: マザーエージェントとスペシャリストエージェントのプロンプト生成、およびエージェントの作成ロジック (`run_specialist_agents` ツールを含む)。

## ライセンス

このプロジェクトは Apache License 2.0 の下で提供されています。

## 謝辞

このプロジェクトは HuggingFace の `smolagents` ライブラリにインスパイアされています。