# 权大师商标数据 MCP

权大师商标数据 MCP 将中国及全球商标数据能力接入 WorkBuddy、CodeBuddy 及其他兼容 Model Context Protocol 的 AI 客户端。

本仓库提供一个开源的本地适配器。适配器通过标准输入输出与 AI 客户端通信，并使用企业专属 AppKey 安全连接权大师远程 MCP 服务。AppKey 只从本地环境变量读取，不会写入代码或日志。

## 可用能力

实际可见工具以企业账户已开通范围为准，主要包括：

- 中国商标检索
- 全球商标检索
- 中国及全球商标公告查询
- 尼斯分类查询
- 商标评审文书查询
- 商标转让记录查询
- 申请人风险线索查询

用户加购能力后无需更换 AppKey，客户端重新获取工具列表即可发现新增工具。

## 使用前准备

1. Node.js 18 或更高版本。
2. 权大师提供的企业 AppKey。

申请试用或正式开通请访问[权大师官网](https://www.quandashi.com/)或联系 `info@quandashi.com`。

## WorkBuddy 配置

进入 WorkBuddy 的“插件 → MCP 服务器 → 配置 MCP”，添加以下配置：

```json
{
  "mcpServers": {
    "quandashi-trademark": {
      "command": "npx",
      "args": ["-y", "@quandashi/trademark-mcp@latest"],
      "env": {
        "QUANDASHI_MCP_URL": "https://ai.quandashi.com/mcp/ipmaster_platform/",
        "QUANDASHI_APP_KEY": "YOUR_ISSUED_APP_KEY",
        "QUANDASHI_AUTH_HEADER": "Authorization",
        "QUANDASHI_AUTH_SCHEME": "Bearer"
      }
    }
  }
}
```

将 AppKey 占位符替换为开通时发放的值。保存后，MCP Server 状态应显示为绿色。

## 安全说明

- 不要把 AppKey 提交到 Git、工单、截图或公开聊天记录。
- 仅连接权大师正式发放的 HTTPS 服务地址。
- Tool 调用会以对应企业身份执行，并按已开通产品的规则计费。
- 调用成功扣点；鉴权失败、未购买、余额不足或平台异常不扣点。正式口径以合同及开通说明为准。
- 商标检索结果和风险线索仅供业务研究及人工复核，不构成法律意见，也不保证注册结果。

## 本地开发

```bash
npm install
npm run check
npm test
```

## 工作原理

```text
WorkBuddy / MCP Client
        |
        | stdio
        v
本仓库的公开适配器
        |
        | Streamable HTTP + 企业 AppKey
        v
权大师远程 MCP Gateway
```

适配器不复制商标数据，也不在本地保存查询结果。工具定义和调用结果由企业账户对应的远程 MCP Gateway 提供。

## License

MIT License。权大师商标数据、接口服务、品牌与业务内容不因本仓库开源而开放授权。