# @cookiemunch/mcp 中文文档

规范地址：https://npmcn.com/package/%40cookiemunch/mcp/

版本：0\.18\.0
npm 元数据更新时间：2026-11-04T18:37:16.585Z
中文译文更新时间：2026-11-10T19:22:39.046Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cookiemunch/mcp
原文对照：https://npmcn.com/package/%40cookiemunch/mcp/?lang=original
项目主页：https://cookiemunch.net/docs
源码仓库：https://github.com/Cookie-Munch/mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.3 MB，23 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-10-14T16:37:09.517Z
- 最新版本发布：2026-11-04T18:37:16.244Z
- 近 30 天下载量：3345（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

Cookie Munch 开发者 API 的模拟上下文协议服务器

## 安装

```sh
npm install @cookiemunch/mcp
```

也可以使用：`pnpm add @cookiemunch/mcp`、`yarn add @cookiemunch/mcp`、`bun add @cookiemunch/mcp`

## README

# 翻译:

A 类 [示范背景协议](https://modelcontextprotocol.io/) 显示 Cookie Munch 开发者 API (即 `/v1` 作为MCP工具,建在顶部 [`@cookiemunch/sdk`](https://npmcn.com/package/%40cookiemunch/sdk)。指向 MCP 客户端( Claude Desktop, Claude Code,...) 在它和一个助手可以管理网站,阅读同意分析,并驱动隐私 代表您操作.

## 如何认证

服务器从环境中读取一个 API 密钥,并从中获取您的组织 它的服务器侧,你从来没有通过一个 `orgId`。 。 。 .

| 新闻 var | 需求 | 默认 |
| --- | --- | --- |
| `COOKIEMUNCH_API_KEY` | 对 | —— 说 |
| `COOKIEMUNCH_BASE_URL` | 没有 | `https://api.cookiemunch.net` |

从仪表盘中生成一个密钥( 它看起来像 `fck_…`) (中文(简体) ).

## 工具

| 工具 | 说明 |
| --- | --- |
| `whoami` | 身份绑定在API密钥上(orgId, plan, key prefix). |
| `list_sites` | 列出您 Org 中的所有站点( cids) . |
| `create_site` | 创建站点( 如果省略则自动生成) . |
| `get_site_config` | 获得网站旗/同意配置. |
| `update_site_config` | Upsert (相接) 一个站点的配置. |
| `get_consent_stats` | 每日同意统计汇总. |
| `get_consent_log` | 最近匿名同意记录. |
| `list_dsar` | 列表数据主题访问请求. |
| `create_dsar` | 打开一个新的 DSAR . |
| `advance_dsar` | 将 DSAR 移动到新状态 . |
| `list_vendors` | 拥有计算出的风险分数的供应商. |
| `list_ropa` | 处理活动记录. |
| `get_rights_page`, (中文(简体) ), `update_rights_page`, (中文(简体) ), `patch_rights_page`, (中文(简体) ), `preview_rights_page` | 阅读、替换、更改或干燥主机权利页面草稿。 过 `baseUpdatedAt` 因此,更新的保存是冲突,而不是覆盖. |
| `publish_rights_page`, (中文(简体) ), `get_published_rights_page`, (中文(简体) ), `list_rights_page_versions`, (中文(简体) ), `rollback_rights_page` | 出版(一时活出),阅读活出页及其历史,回滚. 回滚取代草稿;通过 `baseUpdatedAt` 对两者. |
| `list_rights_page_domains`, (中文(简体) ), `add_rights_page_domain`, (中文(简体) ), `verify_rights_page_domain`, (中文(简体) ), `remove_rights_page_domain` | 在您的主机名上服务权利页面 . |
| `create_rights_link` | 一个签名的,单使用权页面链接的签名人. |
| `get_mail_provider`, (中文(简体) ), `set_mail_provider`, (中文(简体) ), `test_mail_provider`, (中文(简体) ), `remove_mail_provider` | 您自己为权利请求邮件提供电子邮件服务 . |

完整列表, 与每一个参数 [cookymunch.net/docs/mcp-工具](https://cookiemunch.net/docs/mcp-tools)。 。 。 .

## 客户端配置

### 克洛德桌面/克洛德代码

添加到您的 MCP 服务器配置( E)`claude_desktop_config.json`,或通过 `claude mcp add`:

```json
{
  "mcpServers": {
    "cookiemunch": {
      "command": "npx",
      "args": ["-y", "@cookiemunch/mcp"],
      "env": {
        "COOKIEMUNCH_API_KEY": "fck_your_key_here"
      }
    }
  }
}
```

或者,从当地检查后 `pnpm --filter @cookiemunch/mcp build`数字 :

```json
{
  "mcpServers": {
    "cookiemunch": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp/dist/bin.js"],
      "env": {
        "COOKIEMUNCH_API_KEY": "fck_your_key_here"
      }
    }
  }
}
```

## 程序使用

```ts
import { createCookieMunchMcp } from '@cookiemunch/mcp';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = createCookieMunchMcp({ apiKey: process.env.COOKIEMUNCH_API_KEY!, baseUrl: 'https://api.cookiemunch.net' });
await server.connect(new StdioServerTransport());
```

## 常见问题

### @cookiemunch/mcp 是什么？

Cookie Munch 开发者 API 的模拟上下文协议服务器

### 如何安装 @cookiemunch/mcp？

在项目目录运行 npm install @cookiemunch/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cookiemunch-mcp，可以用 npx cookiemunch-mcp 直接运行。

### @cookiemunch/mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cookiemunch/mcp 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @cookiemunch/mcp 可以商用吗？

@cookiemunch/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cookiemunch/mcp 的下载量有多少？

根据 npm 官方下载统计，@cookiemunch/mcp 在 2026/10/11 – 2026/11/09 这 30 天内被下载 3,345 次，日均约 112 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cookiemunch/mcp 还在维护吗？

最新版本 0\.18\.0 发布于 2026/11/05（6 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/10/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。