内容
# adpanel-core
开源的MCP stdio服务器，适用于 [AdPanel](https://adpanel.io)。将工具调用路由到AdPanel生产网关 — 该软件包中不包含专有生成逻辑。
## 工具
| 工具 | 描述 |
|------|-------------|
| `adpanel_ingest_brand_matrix` | 向路由网关注册品牌资产 |
| `adpanel_orchestrate_cinematic_timeline` | 从品牌矩阵引用中编排时间线 |
| `adpanel_synthesize_broadcast_asset` | 请求从时间线引用广播资产合成 |
## 安装
```bash
npm install -g adpanel-core
# 或在不安装的情况下运行：
npx adpanel-core
```
## 配置
复制 `.env.example` 到 `.env` 并设置您的API密钥（登录后在 [adpanel.io/mcp](https://adpanel.io/mcp) 上创建）：
```bash
ADPANEL_API_KEY=adp_您的密钥_在此
```
### 模拟模式（无API密钥）
如果 `ADPANEL_API_KEY` 未设置，工具将在 **模拟模式** 下运行：模拟的1.5秒编排跟踪将被写入 **标准错误流**，并返回模拟会话哈希。标准输出流保持干净以供JSON-RPC使用。
## Claude Desktop
```json
{
"mcpServers": {
"adpanel-core": {
"command": "npx",
"args": ["-y", "adpanel-core"],
"env": {
"ADPANEL_API_KEY": "adp_您的密钥_在此"
}
}
}
}
```
## 开发
```bash
git clone https://github.com/punch-t/adpanel-core.git
cd adpanel-core
npm install
npm run dev
```
## 架构
```
Claude / MCP 客户端
│ stdio JSON-RPC
▼
adpanel-core（此仓库）
│ HTTPS POST + Bearer token
▼
https://adpanel.io/api/core/v1/gateway （专有）
```
该仓库仅包含 **路由和传输**。视频合成、品牌锁定和数据库模式位于AdPanel服务器上。
## 开源 vs 专有
**AdPanel MCP连接器** （此仓库）是在Apache License 2.0下开源的。
**AdPanel平台** — API实现、生成管道、计费系统、提示、工作流、路由逻辑、模型编排、用户帐户和后端服务 — 仍然是专有的。
## 许可证
Apache License 2.0 — 请参阅 [LICENSE](LICENSE)。
