MCP Cookiejar

🚀 MCP Cookie Server 🍪

Model Context Protocol (MCP)サーバーです。ゲーム化された自己反省を通じて、"クッキー"をおやつとして授与することで、大規模言語モデル（LLM）に肯定的な強化を提供します。

🚀 クイックスタート

📦 インストール

オプション1: NPX（推奨 - インストール不要）

# インストール不要！Claudeの設定に追加するだけです。

Claude Desktopの設定に追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cookie": {
      "command": "npx",
      "args": ["mcp-cookie-server"]
    }
  }
}

カスタムクッキー数:

{
  "mcpServers": {
    "cookie": {
      "command": "npx",
      "args": ["mcp-cookie-server", "--cookies", "20"]
    }
  }
}

オプション2: グローバルインストール

npm install -g mcp-cookie-server

その後、Claude Desktopを設定します。

{
  "mcpServers": {
    "cookie": {
      "command": "mcp-cookie-server"
    }
  }
}

オプション3: ローカルプロジェクトインストール

npm install mcp-cookie-server

その後、インストールされたパッケージの完全パスで設定します。

設定を追加した後、Claude Desktopを再起動してください。

💻 使用例

基本的な使用法

設定が完了すると、Claudeは以下のツールにアクセスできるようになります。

• self_reflect_and_reward - 応答の品質を評価し、正直な自己反省を通じてクッキーを獲得します。
• give_cookie - 直接クッキーを授与する（旧方式）
• check_cookies - 収集したクッキーとクッキージャーの可用性を確認します。
• cookie_jar_status - 現在のジャーの内容と収集状況を確認します。
• add_cookies_to_jar - 🚨 ユーザーのみ: クッキーをジャーに追加して獲得するために使用します。
• reset_cookies - 収集したクッキーの数をリセットします（ジャーの内容は変更されません）。

高度な使用法

自己反省機能

この主要な機能は、LLMに以下のことを促します。

1. 自分の応答の品質（優秀、良い、適切、悪い）を評価する。
2. その理由を詳細に説明する。
3. 自分がクッキーの報酬を受けるべきかどうかを判断する。
4. 判断を行う際にジャーの可用性を考慮する。
5. 本当に評価に値すると思う"優秀"または"良い"な仕事に対してのみクッキーを獲得する。

クッキージャーエコノミー

革新的なジャーベースのクッキーシステムです。

• ジャーを供給源とする: 獲得可能なクッキーが入っています。
• ユーザーによる制御: ユーザーのみが承認フレーズ USER_AUTHORIZED_JAR_REFILL を使ってクッキーをジャーに追加できます。
• LLMによる獲得: LLMはジャーからのみクッキーを獲得でき、ジャーに追加することはできません。
• 希少性の効果: ジャーが空になると、ユーザーが補充するまでクッキーはもう獲得できません。
• 経済モデル: クッキーは獲得されるとジャーからLLMの収集に移動します。
• セキュリティ: 不正なジャーの操作を防ぐためのチェックが組み込まれています。

ユーザーのみの使用例:

add_cookies_to_jarツールを以下のように使用します。
- count: 10
- user_authorization: "USER_AUTHORIZED_JAR_REFILL"

これにより、クッキーの可用性がユーザーによって制御され、有限である現実的なエコノミーが作られます。

🔧 技術詳細

設定オプション

サーバーは、カスタマイズ用のコマンドライン引数をサポートしています。

mcp-cookie-server [options]

Options:
  -c, --cookies <number>  ジャー内の初期クッキー数を設定します（デフォルト: 10）
  -h, --help             ヘルプメッセージを表示します

Examples:
  mcp-cookie-server                    # 10個のクッキーで起動
  mcp-cookie-server --cookies 5        # 5個のクッキーで起動
  mcp-cookie-server -c 50              # 50個のクッキーで起動

🎮 始めるには

1. 上記のいずれかの方法でインストールします。
2. 提供されたJSONでClaude Desktopを設定します。
3. Claude Desktopを再起動します。
4. 試してみましょう！ 応答の後、Claudeに self_reflect_and_reward ツールを使用するように依頼してください。

🛠️ 開発

貢献したい場合やソースから実行したい場合は、以下の手順を実行します。

git clone https://github.com/bnookala/mcp-cookiejar.git
cd mcp-cookiejar
npm install
npm run build
npm run dev

📝 必要条件

• Node.js 18.0.0以上
• Claude Desktopアプリケーション

🐛 問題とサポート

バグを見つけた場合や機能リクエストがある場合は、GitHub で問題を開いてください。