Trademark MCP Server

商标MCP服务器

](https://smithery.ai/server/@jordanburke/trademark-mcp-server)

一种模型上下文协议（MCP）服务器，提供使用TSDR API搜索和检索USPTO商标信息的工具。

特性

此MCP服务器提供以下工具：

• 商标_搜索_序列号：使用8位序列号搜索商标信息
• 商标_搜索_注册：使用7-8位注册号搜索商标信息
• 商标_状态：获取商标的全面状态信息（HTML格式）
• 商标图片：检索商标图像URL
• 商标文件：获取商标的文档捆绑URL

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的商标mcp服务器 史密瑟里:

npx -y @smithery/cli install @jordanburke/trademark-mcp-server --client claude

手动安装

pnpm install
pnpm build

⚠️ 需要API密钥

重要：自2020年10月起，USPTO TSDR API需要API密钥。您必须：

1. 注册 在 美国专利商标局开发者门户
2. 获取API密钥 从您的帐户仪表板
3. 设置环境变量: USPTO_API_KEY=your_api_key_here

如果没有API密钥，所有请求都将返回401个未经授权的错误。

用法

使用npx（推荐）

您可以直接使用npx运行服务器，而无需安装：

# Set your API key first
export USPTO_API_KEY=your_api_key_here

# Then run the server
npx trademark-mcp-server

这将在stdio模式下启动MCP服务器，准备接收MCP协议消息。

作为MCP服务器（stdio）

如果您在本地安装了该软件包：

pnpm start
# or directly
node dist/bin.js

使用Shell脚本

提供了一个方便的shell脚本：

./start-mcp-server.sh

作为HTTP服务器

# Set your API key first
export USPTO_API_KEY=your_api_key_here

# Start HTTP server (default port 3000)
pnpm serve
# or directly
node dist/server.js

# Or specify a custom port
PORT=8080 pnpm serve

HTTP服务器提供：

• 健康检查： http://localhost:3000/health
• 服务器信息： http://localhost:3000/
• MCP端点： http://localhost:3001/mcp （端口+1上的FastMCP）

🐳 Docker支持

Docker快速入门

将商标服务器作为Docker容器运行：

# Pull and run from GitHub Container Registry
docker run -d \
  --name trademark-mcp-server \
  -p 3000:3000 \
  -e USPTO_API_KEY=your_api_key_here \
  ghcr.io/jordanburke/trademark-mcp-server:latest

Docker Compose

创建一个 docker-compose.yml 文件：

version: '3.8'
services:
  trademark-mcp-server:
    image: ghcr.io/jordanburke/trademark-mcp-server:latest
    ports:
      - "3000:3000"
    environment:
      - USPTO_API_KEY=your_api_key_here
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3000/health"]
      interval: 30s
      timeout: 10s
      retries: 3

然后运行：

docker-compose up -d

在本地构建Docker镜像

# Build the image
docker build -t trademark-mcp-server .

# Run the container
docker run -d \
  --name trademark-mcp-server \
  -p 3000:3000 \
  -e USPTO_API_KEY=your_api_key_here \
  trademark-mcp-server

# View logs
docker logs trademark-mcp-server

# Health check
curl http://localhost:3000/health

Docker镜像详细信息

• 基本图像: node:18-alpine （轻量级Linux发行版）
• 多架构：支持两者 linux/amd64 和 linux/arm64
• 安全：以非root用户身份运行(trademark:nodejs)
• 健康检查：内置健康监测 /health
• 生产就绪：针对生产部署进行了优化

发展

# Set your API key first
export USPTO_API_KEY=your_api_key_here

# Run in development mode with file watching
pnpm serve:dev

# Run with MCP Inspector for debugging and testing
pnpm inspect
# or use the convenience script
./inspect-server.sh

# Run tests
pnpm test

# Lint and format
pnpm lint
pnpm format

MCP检验员测试

MCP检查器为测试MCP服务器提供了一个基于web的界面：

# Start the inspector (opens browser at http://localhost:5173)
pnpm inspect

# Or use the standalone script
./inspect-server.sh

检查员允许您：

• 测试所有工具 通过web UI交互
• 查看服务器功能 以及可用的工具
• 发送请求 并实时查看响应
• 调试问题 详细记录
• 验证 MCP协议合规性

使用的API端点

此服务器使用USPTO TSDR（商标状态和文档检索）API：

• 基本URL: https://tsdrapi.uspto.gov/ts/cd
• 状态信息（JSON）: /casestatus/sn[SERIAL]/info.json 或 /casestatus/rn[REGISTRATION]/info.json
• 状态信息（HTML）: /casestatus/sn[SERIAL]/content.html
• 商标图片: /rawImage/[SERIAL]
• 文件包: /casedocs/bundle.pdf?sn=[SERIAL]

获取API密钥

1. 访问 美国专利商标局开发者门户
2. 创建帐户或登录
3. 导航到您的帐户仪表板
4. 为TSDR访问生成新的API密钥
5. 复制API密钥以便与此服务器一起使用

有关API密钥的问题，请联系： APIhelp@uspto.gov

速率限制

• 常规API调用：每个API键每分钟60个请求
• PDF/ZIP下载：每个API密钥每分钟4次请求

示例用法

您可以使用MCP检查器测试这些示例(pnpm inspect)或者直接调用工具。

按序列号搜索

// Example serial number: 78787878
{
  "name": "trademark_search_by_serial",
  "arguments": {
    "serialNumber": "78787878"
  }
}

按注册号搜索

// Example registration number: 1234567
{
  "name": "trademark_search_by_registration", 
  "arguments": {
    "registrationNumber": "1234567"
  }
}

获取商标图片

{
  "name": "trademark_image",
  "arguments": {
    "serialNumber": "78787878"
  }
}

使用真实数据进行测试

在MCP检查器中尝试以下工作示例：

• 苹果商标：序列号 78462704
• Nike商标：序列号 72016902
• 微软商标：序列号 78213220

Claude桌面配置

使用npx（推荐）

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "trademark-mcp-server": {
      "command": "npx",
      "args": ["trademark-mcp-server"],
      "env": {
        "USPTO_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用本地安装

如果您在本地安装了该软件包：

{
  "mcpServers": {
    "trademark-mcp-server": {
      "command": "node",
      "args": ["/path/to/trademark-mcp-server/dist/bin.js"],
      "env": {
        "USPTO_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用Shell脚本

您还可以使用提供的shell脚本：

{
  "mcpServers": {
    "trademark-mcp-server": {
      "command": "/path/to/trademark-mcp-server/start-mcp-server.sh",
      "env": {
        "USPTO_API_KEY": "your_api_key_here"
      }
    }
  }
}

许可证

麻省理工学院

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 运行测试和梳理： pnpm test && pnpm lint
5. 提交拉取请求

api参考

有关USPTO TSDR API的更多信息，请访问：

• 美国专利商标局开发者门户
• TSDR API Swagger文档