originselect-mcp-server

OriginSelect MCP Server

用于 OriginSelect 的 Model Context Protocol 服务——让 AI Agent 搜索符合伦理标准且产地经过验证的产品和品牌。

兼容 Claude Desktop、Cursor、Windsurf 以及任何兼容 MCP 的客户端。

请参阅 OriginSelect 开发者页面，了解 API 文档和其他集成选项。

快速开始

选项 1：npx（推荐）

无需安装——只需添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "originselect": {
      "command": "npx",
      "args": ["originselect-mcp-server"]
    }
  }
}

选项 2：全局安装

npm install -g originselect-mcp-server

然后添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "originselect": {
      "command": "originselect-mcp-server"
    }
  }
}

选项 3：从源代码安装

git clone https://github.com/chhavimishra/originselect-mcp-server.git
cd originselect-mcp-server
npm install

{
  "mcpServers": {
    "originselect": {
      "command": "node",
      "args": ["/absolute/path/to/originselect-mcp-server/src/index.js"],
      "env": {
        "API_BASE_URL": "https://api.originselect.com"
      }
    }
  }
}

Cursor / Windsurf

添加到 MCP 设置中：

{
  "originselect": {
    "command": "npx",
    "args": ["originselect-mcp-server"]
  }
}

示例查询

连接后，向 AI 助手提问：

• “查找来自加拿大、价格低于 $25 的有机婴儿用品”
• “给我看看美国由女性拥有的咖啡品牌”
• “有哪些获得 B Corp 认证的护肤品牌？”
• “查找纯素、无残忍对待动物的宠物用品”

工具

search_products

按价值观、国家、类别、品牌或关键词搜索精选产品目录。

"Find organic baby products from Canada under $25"
→ { country: "Canada", category: "Baby", values: ["organic"], priceMax: 25 }

参数	类型	描述
query	string	可选的自然语言查询，用于提供上下文
country	string	原产国（Canada、USA）
category	string	产品类别（Beauty、Baby、Pet Care 等）
values	string[]	伦理价值观（women-owned、organic、b-corp 等）
brand	string	品牌名称
keywords	string[]	产品关键词（shampoo、coffee 等）
priceMax	number	最高价格（美元）
market	string	canada、global 或 all（默认值：all）
limit	number	产品数量上限（1-50，默认值：12）

search_brands

按伦理价值观、国家或类别发现品牌。

参数	类型	描述
country	string	原产国
values	string[]	伦理价值观
category	string	产品类别
brand	string	要查询的品牌名称
market	string	市场范围
limit	number	品牌数量上限（1-20，默认值：10）

refine_search

通过添加或移除筛选条件来优化之前的搜索。接收之前 search_products 响应中的 intent 对象并应用修改，无需从头重新查询。

{
  "intent": { "...from previous response..." },
  "modifications": [
    { "action": "add", "field": "values", "value": "organic" },
    { "action": "remove", "field": "values", "value": "vegan" },
    { "action": "modify", "field": "priceMax", "value": 30 }
  ]
}

get_values

列出所有 21 种受支持的伦理／所有权价值观（women-owned、b-corp、organic 等）。

get_categories

列出所有 17 种受支持的产品类别。

get_countries

列出所有受支持的原产国（目前为 Canada 和 USA）。

第一方情报工具

专有的 OriginSelect 流量／收入数据证据——需要 INTELLIGENCE_API_KEY （参见环境变量）。每个响应都设有范围限制，并包含日期窗口和数据新鲜度信息， 还会将归因标记为 deterministic／aggregate／inferred， 让你了解每个数字的可信度。这些工具用于回答“我们自己的网站发生了什么”， 而非进行公开网络研究（SERP、竞争对手）；这类研究请使用你自己的搜索／浏览工具 另行开展。

工具	用途
get_daily_priorities	按优先级排序的热门机会，附带证据和原因代码
get_page_performance	单个 URL 的跨渠道表现
get_query_performance	单个查询在不同引擎和页面上的表现
get_page_queries	为单个页面带来流量的查询
get_query_pages	针对单个查询排名的页面
get_ranking_changes	随时间变化的页面查询排名上升／下降情况
get_ctr_opportunities	排名位置对应的点击率较低的页面／查询
get_cannibalization	页面曝光度重叠的查询
get_channel_performance	单个页面在 Google／Bing／Pinterest／AI 上的表现明细
get_affiliate_performance	按计划和市场划分的联盟点击量／收入／佣金
get_ai_referral_performance	单个页面来自 AI 引擎的引荐行为
get_change_history	单个页面的已记录构建／内容变更
get_data_freshness	所有情报数据源的连接器状态

架构

AI Agent (Claude, GPT, Cursor)
    │
    │  MCP (stdio)
    ▼
┌─────────────────────────┐
│  MCP Server (this pkg)  │
│  19 tools               │
└───────────┬─────────────┘
            │  HTTPS
            ▼
┌─────────────────────────┐
│  OriginSelect API       │
│  api.originselect.com   │
└─────────────────────────┘

环境变量

变量	默认值	描述
API_BASE_URL	https://api.originselect.com	Discovery API 基础 URL
INTELLIGENCE_API_KEY	(none)	仅上述情报工具需要；产品搜索无需此密钥

支持的值

women-owned · black-owned · indigenous-owned · veteran-owned
family-owned · lgbtq-owned · aapi-owned · latino-owned · minority-owned
b-corp · organic · sustainable · vegan · non-gmo · fair-trade
non-toxic · cruelty-free · fragrance-free · plastic-free
social-impact · gluten-free

安全与信任

此 MCP 服务是开源的，并且完全可审计：

• 只读——仅向 api.originselect.com 发出 HTTPS 请求
• 无文件系统访问——不会读取或写入任何本地文件
• 无遥测——不会向任何地方发送用户数据或分析数据
• 依赖项极少——仅有一个运行时依赖项（@modelcontextprotocol/sdk）
• 源代码——github.com/chhavimishra/originselect-mcp-server

如需报告漏洞，请参阅 SECURITY.md。

许可证

MIT

私有 ChatGPT 传输方式（已准备，但尚未发布或部署）

现有的 src/index.js stdio 入口和 19 个工具的清单保持不变。私有 Codex 连接可以继续使用当前的启动器和服务端 INTELLIGENCE_API_KEY 配置。

originselect-mcp-server/intelligence 导出 createIntelligenceServer，这是一个独立工厂，复用现有的 13 个 intelligence 描述符。它需要经过身份验证的读取分发器；其中不包含目录或变更分发，并添加了严格的 schema、OAuth 元数据和只读注解。仅远程选项会提供固定的仅页面基线，以及附带日期的国家/设备诊断信息。这些选项不会更改旧版 stdio schema。

现有的 OriginSelect 后端会通过无状态 Streamable HTTP，在拟议的 https://mcp.originselect.com/mcp 端点挂载此工厂。Cognito 通过官方 MCP SDK OAuth 代理处理用户登录、PKCE 和令牌刷新。后端控制器会直接执行读取操作：不会向 ChatGPT 提供 intelligence API key，不会将其放入 URL，也不会在 OAuth 令牌中转发。

后端会安装由其 scripts/vendor-private-mcp.mjs 生成的本地 vendor/originselect-mcp-server-1.0.12.tgz；无需发布到 npm。更改此工厂或其描述符后，请重新构建该制品并更新后端锁文件。供应商化清单会记录归档校验和。

部署、所有者允许名单、ChatGPT 连接说明和回滚流程记录在后端的 intelligence/mcp/README.md 中。本地 SDK 测试不等同于 ChatGPT 验收：在实际经过身份验证的 ChatGPT 调用与保存的 2026 年 8 月 8 日至 9 月 4 日仅页面证据相符之前，部署仍未通过验收。