MCP 服务器

Trademark Big Data MCP Server

Provides comprehensive trademark information services, including fuzzy company search, detailed trademark status tracking, and statistical analysis. Users can analyze trademark portfolios by tracking application trends, registration data, and category distributions for specific companies.

README

商标大数据服务

该MCP服务提供全面的商标信息查询功能，包括商标搜索、商标概况统计等，帮助用户进行商标查询、情况分析和状态跟踪。

主要功能

🔍 企业关键词模糊搜索
📄 商标信息搜索
📊 企业商标概况统计
📈 商标统计分析

环境要求

Python 3.10+
依赖包：python-dotenv, requests, mcp

本地快速启动

1. 克隆项目

git clone https://github.com/handaas/trademark-mcp-server
cd trademark-mcp-server

2. 创建虚拟环境&安装依赖

python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

3. 环境配置

复制环境变量模板并配置：

cp .env.example .env

编辑 .env 文件，配置以下环境变量：

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. streamable-http启动服务

python server/mcp_server.py streamable-http

服务将在 http://localhost:8000 启动。

支持启动方式 stdio 或 sse 或 streamable-http

5. Cursor / Cherry Studio MCP配置

{
  "mcpServers": {
    "handaas-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

STDIO版安装部署

设置Cursor / Cherry Studio MCP配置

{
  "mcpServers": {
    "trademark-mcp-server": {
      "command": "uv",
      "args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
      "env": {
        "PATH": "{workdir}/mcp_env/bin:$PATH",
        "PYTHONPATH": "{workdir}/mcp_env",
        "INTEGRATOR_ID": "your_integrator_id",
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key"
      }
    }
  }
}

使用官方Remote服务

1. 直接设置Cursor / Cherry Studio MCP配置

{
  "mcpServers": {
    "trademark-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/trademark/trademark_bigdata?token={token}"  
      }
  }
}

注意：integrator_id、secret_id、secret_key及token需要登录 https://www.handaas.com/ 进行注册开通平台获取

可用工具

1. trademark_bigdata_fuzzy_search

功能: 企业关键词模糊查询

根据提供的企业名称、人名、品牌、产品、岗位等关键词模糊查询相关企业列表。

参数:

matchKeyword (必需): 匹配关键词 - 查询各类信息包含匹配关键词的企业
pageIndex (可选): 分页开始位置
pageSize (可选): 分页结束位置 - 一页最多获取50条数据

返回值:

total: 总数
其他企业相关信息

2. trademark_bigdata_trademark_search

功能: 商标信息搜索

根据商标名称、申请号、申请人名称或代理机构名称等条件进行查询，并通过商标状态进一步过滤结果。

参数:

matchKeyword (必需): 匹配关键词 - 商标名称/申请号/申请人名称/代理机构名称
keywordType (可选): 搜索方式 - 商标名称，申请号，申请人，代理机构，默认匹配全部
pageIndex (可选): 页码 - 从1开始
pageSize (可选): 分页大小 - 一页最多获取50条数据
tmStatus (可选): 商标状态 - 驳回复审中，撤销/无效宣告申请审查中，初审公告等

返回值:

resultList: 商标列表
- _id: 商标id
- tmAgentName: 代理机构名称
- tmAgentNameId: 代理机构id
- tmCompanyNameId: 申请人id
- tmName: 商标名称
- tmImage: 商标图片链接
- tmApplicationTime: 申请日期
- tmCompanyName: 申请人名称
- tmRegNum: 申请号
- tmRegTime: 注册日期
- tmServiceContents: 商品服务项
- tmStatus: 商标状态
- tmTrialTime: 初审公告日期
total: 商标数量