MCP Cookiejar

🚀 MCP Cookie Server 🍪

MCP Cookie Server 是一個基於模型上下文協議（MCP）的服務器，它通過遊戲化的自我反思機制，為大語言模型（LLMs）提供“餅乾”獎勵，以此給予積極反饋。

🚀 快速開始

安裝與配置

方式一：使用 NPX（推薦 - 無需安裝）

# 無需安裝！只需添加到你的 Claude 配置中：

添加到 Claude 桌面端配置：

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"]
    }
  }
}

方式二：全局安裝

npm install -g mcp-cookie-server

然後配置 Claude 桌面端：

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

方式三：本地項目安裝

npm install mcp-cookie-server

然後使用已安裝包的完整路徑進行配置。

添加配置後，重啟 Claude 桌面端。

使用方法

配置完成後，Claude 可以使用以下工具：

• self_reflect_and_reward - 評估回覆質量，並通過誠實的自我反思獲得餅乾
• give_cookie - 直接授予餅乾（舊方法）
• check_cookies - 檢查已收集的餅乾數量和餅乾罐的可用性
• cookie_jar_status - 檢查當前餅乾罐的內容和收集狀態
• add_cookies_to_jar - 🚨 僅限用戶：向餅乾罐中添加餅乾以用於獎勵
• reset_cookies - 重置已收集的餅乾數量（餅乾罐內容不變）

✨ 主要特性

自我反思功能

該主要特性鼓勵大語言模型（LLMs）：

1. 評估 其回覆質量（優秀、良好、一般、較差）
2. 詳細解釋 其評估理由
3. 決定 是否值得獲得餅乾獎勵
4. 考慮 餅乾罐的可用性再做決策
5. 僅為 它們真正認為值得認可的“優秀”或“良好”工作 賺取 餅乾

餅乾罐經濟系統

這是一個創新的基於餅乾罐的系統：

• 餅乾罐作為來源：包含可供賺取的餅乾
• 用戶控制：只有用戶可以使用授權短語 USER_AUTHORIZED_JAR_REFILL 向餅乾罐中添加餅乾
• 大語言模型賺取：大語言模型只能從餅乾罐中賺取餅乾，不能向其中添加
• 稀缺效應：餅乾罐為空時，在用戶重新填充之前無法再獲得餅乾
• 經濟模型：賺取餅乾時，餅乾從餅乾罐轉移到大語言模型的收藏中
• 安全性：內置檢查機制，防止未經授權的餅乾罐操作

示例用法（僅限用戶）：

使用 add_cookies_to_jar 工具，並提供以下參數：
- count: 10
- user_authorization: "USER_AUTHORIZED_JAR_REFILL"

這創建了一個現實的經濟系統，其中餅乾的可用性由用戶控制且數量有限。

🔧 技術細節

配置選項

服務器支持通過命令行參數進行自定義配置：

mcp-cookie-server [options]

選項：
  -c, --cookies <number>  設置餅乾罐中的初始餅乾數量（默認值：10）
  -h, --help             顯示幫助信息

示例：
  mcp-cookie-server                    # 以 10 塊餅乾啟動
  mcp-cookie-server --cookies 5        # 以 5 塊餅乾啟動  
  mcp-cookie-server -c 50              # 以 50 塊餅乾啟動

開發

如果你想貢獻代碼或從源代碼運行：

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 桌面端應用程序

問題與支持

如果你發現了 bug 或有功能請求，請在 GitHub 上提交問題。