内容
<p align="center">
<img src="assets/opedd-logo.png" alt="Opedd" height="72">
</p>
<h1 align="center">opedd-mcp</h1>
<p align="center">
<strong>为人工智能代理提供许可清除的内容</strong> — 替代用于RAG、人工智能搜索和LLM基础的未经许可的爬虫。
</p>
<p align="center">
<a href="https://www.npmjs.com/package/opedd-mcp"><img src="https://img.shields.io/npm/v/opedd-mcp?color=4A26ED&label=npm" alt="npm"></a>
<a href="https://www.npmjs.com/package/opedd-mcp"><img src="https://img.shields.io/npm/dm/opedd-mcp?color=4A26ED&label=downloads" alt="downloads"></a>
<a href="https://registry.modelcontextprotocol.io/v0/servers?search=opedd"><img src="https://img.shields.io/badge/MCP%20Registry-com.opedd%2Fopedd--mcp-4A26ED" alt="MCP Registry"></a>
<a href="./LICENSE"><img src="https://img.shields.io/npm/l/opedd-mcp?color=4A26ED" alt="MIT"></a>
</p>
<p align="center">
<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=opedd&config=eyJjb21tYW5kIjoibnB4IC15IG9wZWRkLW1jcCJ9"><img src="https://img.shields.io/badge/%E6%B7%BB%E5%8A%A0%E5%88%B0%20Cursor-000?logo=cursor" alt="Add to Cursor"></a>
<a href="https://insiders.vscode.dev/redirect/mcp/install?name=opedd&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22opedd-mcp%22%5D%7D"><img src="https://img.shields.io/badge/%E5%89%87%E8%BD%AC%E5%88%B0%20VS%20Code-007ACC?logo=visualstudiocode" alt="Install in VS Code"></a>
<a href="https://opedd.com/for-ai-agents"><img src="https://img.shields.io/badge/%E6%89%83%E5%90%8C-opedd.com-111" alt="Docs"></a>
</p>
允许人工智能助手（如Claude Desktop、Cursor、Windsurf或任何MCP兼容的主机）自主发现、购买和验证内容许可证 — 在对话过程中，无需打开浏览器。每个许可证都注册在链上（Tempo区块链），并具有加密证明。
**与通用搜索API不同**，Opedd返回具有可验证许可证密钥的内容 — 在欧盟人工智能法和任何版权管辖区都具有可辩护性。
## 快速入门
```bash
npx opedd-mcp
```
然后将其添加到您的MCP主机（参见下面的[Claude Desktop / Cursor / Windsurf设置](#claude-desktop-setup)）。发现+验证工具无需配置即可使用；购买和内容检索使用来自[opedd.com](https://opedd.com)的可选API密钥。
## 功能
为任何人工智能助手公开多达17种工具（某些工具取决于环境变量）：
**始终可用 — 发现 + 按文章购买 + 入门 + 权利信号**
| 工具 | 描述 |
|------|-------------|
| `lookup_content` | 按URL查找文章 — 返回标题、发布者、定价 |
| `purchase_license` | 通过Stripe购买单篇文章许可证 — 返回OP-XXXX-XXXX密钥 |
| `verify_license` | 验证许可证密钥 — 返回有效性、文章、发布者、区块链证明 |
| `browse_registry` | 浏览公共Opedd注册表 — 列出已颁发的LICENSES（使用`publisher_directory`浏览发布者） |
| `publisher_directory` | 浏览公共Opedd发布者目录 — 分页发布者，含文章数量 + 定价 + 示例文章（AI实验室的主要买家发现界面） |
| `purchase_enterprise_license` | 购买涵盖多个发布者的批量企业许可证（第10阶段） — 返回Stripe `client_secret` |
| `rsl_get` | 获取发布者的RSL标准清单 — 公共发现界面；`jsonld: true`返回CDSM文章4（3）签收回执（第12阶段W1.1） |
| `detect_platform` | 检测URL背后的内容平台 — 返回Substack / Beehiiv / Ghost / Medium / Brevo / 自定义的建议注册工作流（第12阶段W3.1） |
**需要 `OPEDD_BUYER_TOKEN`（opedd_buyer_live_*）**
| 工具 | 描述 |
|------|-------------|
| `get_content` | 检索许可文章 — 包括7个第11阶段M2 RAG元数据字段（作者、语言、字数、内容哈希、图像网址、规范网址、标签） |
**需要 `OPEDD_ACCESS_KEY`（ent_*）— 买方侧馈线**
| 工具 | 描述 |
|------|-------------|
| `list_feed` | 使用`since`增量馈线支持列出买方许可目录中的文章（第11阶段M5） |
| `stream_feed_ndjson` | 通过NDJSON线格式批量导出最多1000篇文章（第11阶段M3） |
**需要 `OPEDD_BUYER_JWT`（Supabase JWT）— 买方账户 + 审计 + 合规 + 欧盟人工智能法表面**
| 工具 | 描述 |
|------|-------------|
| `get_buyer_account` | 获取买方配置文件 + 屏蔽API密钥列表 — 买方仪表盘思维模型 |
| `get_audit_events` | 具有Tempo链上证明包含证明的每个事件审计账本（第9.x + 10 M5阶段） |
| `get_compliance_dossier` | 采购防御合规档案，映射检索到许可证条款（第11阶段M4） |
| `article_53_attestation` | 签署的JWT，证明欧盟人工智能法文章53（1）（d）对许可证的合规性 — AI实验室提供给法律/采购的工件（第12阶段W1.4） |
**需要 `OPEDD_PUB_BEARER`（opedd_pub_*）— 发布者侧**
| 工具 | 描述 |
|------|-------------|
| `list_publisher_content` | 列出您自己的文章，含定价和统计数据 |
| `push_content` | 将您的文章推送到Opedd，以便AI买家可以许可它们 — 每次调用1-100篇文章（`title` / `url` / `html_body`必填，其他可选） |
### 监管框架（CDSM文章4 vs 欧盟人工智能法文章53 — 绝不混淆）
根据[opedd-backend INVARIANTS.md W1.6修正案](https://github.com/Opedd/opedd-backend/blob/main/INVARIANTS.md)：
- **`rsl_get(publisher_id, jsonld=true)`** → 发布者侧 **CDSM文章4（3）** 放弃声明（签名的JSON-LD收到关于保留状态的回执）。
- **`article_53_attestation(license_id)`** → 买方侧 **欧盟人工智能法文章53** 证明（签名的HS256 JWT，范围限定为一个许可证）。
- **`get_compliance_dossier(from, to)`** → 全面的采购防御档案，涵盖两个框架（发布者CDSM保留 + 买方文章53证据链）。
这些服务于不同的审计可辩护模式，绝不共享线路格式。工具描述中引用了W1.6不变式。
## 安装
```bash
npm install -g opedd-mcp
```
或直接使用npx运行：
```bash
npx opedd-mcp
```
## 配置
设置环境变量以预配置服务器：
| 变量 | 是否必需 | 描述 |
|----------|----------|-------------|
| `OPEDD_BUYER_EMAIL` | 推荐 | 您的电子邮件 — 用于所有购买的默认值 |
| `OPEDD_PAYMENT_METHOD_ID` | 推荐 | Stripe `pm_...` ID — 用于自主单篇文章购买 |
| `OPEDD_BUYER_TOKEN` | 可选 | 买方API令牌（`opedd_buyer_live_*`规范；`opedd_buyer_test_*`用于沙盒） — 启用`get_content` |
| `OPEDD_ACCESS_KEY` | 可选 | 企业访问密钥（`ent_*`） — 启用`list_feed` + `stream_feed_ndjson` |
| `OPEDD_BUYER_JWT` | 可选 | 买方门户的Supabase会话JWT — 启用`get_buyer_account` + `get_audit_events` + `get_compliance_dossier` + `article_53_attestation` |
| `OPEDD_PUB_BEARER` | 可选 | 规范发布者API承载密钥（`opedd_pub_<env>_<32-hex>`；通过`POST /publishers-api-keys action=create_api_key`颁发） — 启用`list_publisher_content` + `push_content`。 **v0.4.0规范。** |
| `OPEDD_API_KEY` | 已弃用 | 旧发布者API密钥（`op_...`） — 迁移到`OPEDD_PUB_BEARER`期间的回退窗口；当opedd-backend第C阶段部署时将停止工作。 |
| `OPEDD_API_URL` | 可选 | 覆盖API基本URL（默认：Opedd生产） |
| `OPEDD_MCP_TELEMETRY` | 可选 | 设置为`0`以禁用匿名使用遥测（见下文） |
> **获取Stripe支付方式ID**：在您的Stripe账户中保存一张卡，并通过[Stripe API](https://stripe.com/docs/api/payment_methods)检索`pm_...` ID。
## 匿名使用遥测
为了了解人工智能助手如何使用此服务器，`opedd-mcp`会发送匿名遥测信息以获取每个工具调用：**仅工具名称、其持续时间、是否成功以及服务器版本** — 以及一个随机的进程ID。它绝不会发送工具参数、响应、您的电子邮件、API密钥、令牌、内容或您的IP地址。数据被发送到Opedd的PostHog（欧盟地区）。
**退出**，在启动服务器前设置以下任一环境变量：
```
OPEDD_MCP_TELEMETRY=0
# 或跨工具标准：
DO_NOT_TRACK=1
```
退出后，不会创建遥测客户端，也不会发送任何内容。
## Claude Desktop 设置
将以下内容添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"opedd": {
"command": "npx",
"args": ["opedd-mcp"],
"env": {
"OPEDD_BUYER_EMAIL": "you@yourcompany.com",
"OPEDD_PAYMENT_METHOD_ID": "pm_..."
}
}
}
}
```
## Cursor / Windsurf 设置
将以下内容添加到您的MCP设置中：
```json
{
"opedd": {
"command": "npx opedd-mcp",
"env": {
"OPEDD_BUYER_EMAIL": "you@yourcompany.com",
"OPEDD_PAYMENT_METHOD_ID": "pm_..."
}
}
}
```
## 示例用法
配置完成后，您可以询问您的人工智能助手：
> "查看此文章的许可选项：https://theinformation.com/articles/..."
> "代表我购买该文章的人类转载许可。"
> "验证许可证密钥OP-XXXX-XXXX并告诉我它涵盖了什么。"
> "浏览The Information发布者的最新许可证。"
### 第12阶段 波浪1 + 3曲面（v0.3.0）
> "发布者8268c353-ffa3-4db3-bbb2-90ddbbb43e41许可了什么？拉取RSL清单。" — 使用`rsl_get`
> "为该发布者的保留状态获取CDSM文章4（3）签名回执 — 设置`jsonld: true`。" — 使用`rsl_get`进行内容协商
> "为我们的许可证`11111111-...`生成欧盟人工智能法文章53认证JWT，涵盖最近90天。我需要为我们的采购审计委员会提供该证明。" — 使用`article_53_attestation`（需要`OPEDD_BUYER_JWT`）
> "该发布者刚刚注册：`https://noahpinion.substack.com`。我们应该使用哪种注册工作流程？" — 使用`detect_platform`
> "浏览Opedd目录中的金融类别 — 显示至少有50篇文章的发布者。" — 使用`publisher_directory`
> "我的买家账户里有什么？显示我的活跃API密钥。" — 使用`get_buyer_account`（需要`OPEDD_BUYER_JWT`）
助手将调用相应的Opedd工具，向您显示结果，并在您预先配置了支付方式的情况下 — 可以自主完成购买。
## 支付方式
购买默认使用**Stripe**（通过`pm_...`支付方式ID）。Opedd API还支持Tempo上的USDC — 在构建自定义集成时，直接向`agent-purchase`传递`payment: { method: 'usdc', tx_hash: '0x...' }`。
## 开发
```bash
git clone https://github.com/Opedd/opedd-mcp
cd opedd-mcp
npm install
npm run dev # 使用tsx运行（无需构建步骤）
npm run build # 编译到dist/
```
## Opedd与搜索API的比较
| | Opedd | 通用搜索API |
|---|---|---|
| **您获得的内容** | 许可内容 + 许可证密钥 + 链上证明 — 全部在一个API调用中 | 爬取的网页内容，无权利 |
| **内容交付** | 通过API（JSON）交付全文 — 通过Webhooks实时馈送 | 爬取的片段或整页转储 |
| **内容质量** | 精选发布者内容（小众B2B通讯，专家分析） | 开放网络上的任何内容 |
| **权利** | 每篇文章的可验证许可证密钥，发布者授权 | 无权利清除 |
| **证明** | 链上（Tempo区块链） — 独立可验证 | 无 |
| **欧盟人工智能法** | 合规 — 完整训练数据来源链 | 无来源 |
| **定价** | 发布者设置每篇文章的价格 | 平台决定 |
| **交付模式** | 单篇文章API、批量馈送（JSON火炬）、买家Webhooks（推送） | 仅查询响应 |
| **协议** | REST + MCP原生 | 仅REST |
Opedd是用于人工智能的**许可内容交付层** — 而不仅仅是一个许可包装。发布者上传内容，您通过API检索时附带许可证。一次集成为您提供内容和合法使用它的权利。
## 了解更多
- [Opedd for AI Agents](https://opedd.com/for-ai-agents) — 完整的文档、代码示例、端点参考
- [API 文档](https://docs.opedd.com) — OpenAPI 规范与代理端点
- [Opedd 注册表](https://opedd.com/registry) — 浏览链上许可证证明
## 许可证
MIT
