MCP Cookiejar

🚀 MCP Cookie Server 🍪

MCP Cookie Server 是一个基于模型上下文协议（MCP）的服务器，它通过游戏化的自我反思机制，为大语言模型（LLMs）提供“饼干”奖励，以实现正向激励，激发模型的优化和提升。

🚀 快速开始

安装与配置

选项 1：使用 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"]
    }
  }
}

选项 2：全局安装

npm install -g mcp-cookie-server

然后配置 Claude 桌面应用：

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

选项 3：本地项目安装

npm install mcp-cookie-server

然后使用已安装包的完整路径进行配置。

添加配置后，请重启 Claude 桌面应用。

✨ 主要特性

工具使用

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

• self_reflect_and_reward - 评估回复质量，并通过诚实的自我反思赚取饼干
• give_cookie - 直接授予饼干（旧方法）
• check_cookies - 检查已收集的饼干数量和饼干罐的可用性
• cookie_jar_status - 检查当前饼干罐的内容和收集状态
• add_cookies_to_jar - 🚨 仅限用户：向饼干罐中添加饼干以用于赚取
• reset_cookies - 重置已收集的饼干数量（饼干罐内容不变）

自我反思功能

该主要功能鼓励大语言模型：

1. 评估 其回复质量（优秀、良好、一般、较差）
2. 详细解释 其评估的理由
3. 决定 是否值得获得饼干奖励
4. 考虑 饼干罐的可用性再做决定
5. 仅为 它们真正认为值得认可的“优秀”或“良好”工作 赚取 饼干

饼干罐经济系统

这是一个创新的基于饼干罐的系统：

• 饼干罐作为来源：包含可供赚取的饼干
• 用户控制：只有用户可以使用授权短语 USER_AUTHORIZED_JAR_REFILL 向饼干罐中添加饼干
• 大语言模型赚取：大语言模型只能从饼干罐中赚取饼干，不能向其中添加
• 稀缺效应：饼干罐为空时，在用户重新填充之前将无法再获得饼干
• 经济模型：赚取饼干时，饼干会从饼干罐转移到大语言模型的收藏中
• 安全性：内置检查机制，防止未经授权的饼干罐操作

示例用法（仅限用户）：

使用 add_cookies_to_jar 工具时，请提供以下参数：
- count: 10
- user_authorization: "USER_AUTHORIZED_JAR_REFILL"

这创建了一个现实的经济系统，其中饼干的可用性由用户控制且数量有限。

📦 安装指南

你可以根据自己的需求选择以下三种安装方式：

• NPX 方式：无需安装，直接添加到配置文件。
• 全局安装：使用 npm install -g mcp-cookie-server 进行全局安装。
• 本地项目安装：在项目中使用 npm install mcp-cookie-server 进行安装。

💻 使用示例

基础用法

配置完成后，Claude 就可以使用上述工具进行操作。例如，使用 self_reflect_and_reward 工具进行自我反思和奖励：

在 Claude 回复后，请求其使用 self_reflect_and_reward 工具进行自我评估和奖励。

高级用法

用户可以使用 add_cookies_to_jar 工具向饼干罐中添加饼干：

使用 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 上提交问题。