Featuriq

featuriq-mcp

面向 Featuriq 的 MCP（模型上下文协议） 服务——为产品经理提供产品反馈和路线图管理工具。

将 Featuriq 工作区连接到任何兼容 MCP 的 AI 客户端（Claude Desktop、Cursor 等），即可通过自然语言查询功能请求、搜索客户反馈、运行 AI 优先级排序、更新状态并通知用户。

---

安装

选项 1 — 使用 npx 直接运行（无需安装）

npx featuriq-mcp

选项 2 — 全局安装

npm install -g featuriq-mcp
featuriq-mcp

---

设置

1. 获取 API 密钥

登录 featuriq.io，前往 设置 → API，然后复制你的 API 密钥。

2. 设置环境变量

export FEATURIQ_API_KEY=fq_live_xxxxxxxxxxxxxxxxxxxx

或者，如果你的客户端支持 .env 文件，请将 .env.example 复制为 .env，并填入密钥。

变量	必需	默认值	描述
FEATURIQ_API_KEY	是	—	你的 Featuriq API 密钥
FEATURIQ_API_URL	否	https://featuriq.io/v1	覆盖 API 基础 URL

3. 添加到 MCP 客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "featuriq": {
      "command": "npx",
      "args": ["featuriq-mcp"],
      "env": {
        "FEATURIQ_API_KEY": "fq_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

添加到 Cursor MCP 设置：

{
  "featuriq": {
    "command": "npx featuriq-mcp",
    "env": {
      "FEATURIQ_API_KEY": "fq_live_xxxxxxxxxxxxxxxxxxxx"
    }
  }
}

---

可用工具

get_top_requests

返回按投票数或收入影响排序的热门功能请求。

参数：

• limit（数字，默认值为 10）— 返回结果的数量
• sort_by（"votes" | "revenue_impact"，默认值为 "votes"）— 排序方式

提示词示例：

• "哪些是请求量最高的 5 个功能？"
• "显示收入影响最大的请求。"

---

search_feedback

使用自然语言对所有反馈帖子进行语义搜索——即使关键词不完全匹配，也能找到相关结果。

参数：

• query（字符串）— 要搜索的内容
• limit（数字，默认值为 10）— 结果数量上限

提示词示例：

• "查找有关仪表板加载缓慢的反馈。"
• "搜索与 CSV 导出相关的请求。"
• "用户对移动端性能有什么看法？"

---

get_feature_feedback

返回某个特定功能请求的所有评论和讨论。

参数：

• feature_id（字符串）— 功能的唯一 ID

提示词示例：

• "显示功能 feat_01j8k... 的所有反馈。"
• "用户对 API 速率限制请求有什么看法？"

---

get_prioritization

返回经过 AI 优先级排序的功能列表，并根据你选择的因素评分。

参数：

• factors（数组）— 以下一个或多个因素："votes"、"revenue"、"effort"、"strategic_fit"
• limit（数字，默认值为 10）

提示词示例：

• "根据投票数和收入影响为我们的待办事项排序。"
• "按投票数、投入和战略契合度排序，列出排名前 10 的功能。"
• "根据收入和战略一致性，我们下个季度应该开发什么？"

---

update_feature_status

更新功能请求的状态。

参数：

• feature_id（字符串）— 功能的唯一 ID
• status（"planned" | "in_progress" | "shipped" | "closed"）

提示词示例：

• "将功能 feat_01j8k 标记为 in_progress。"
• "将深色模式请求设为 shipped。"
• "关闭对旧版 IE 的支持请求。"

---

notify_requesters

向所有为某项功能投过票的用户发送个性化通知。

参数：

• feature_id（字符串）— 要通知投票用户的功能
• message（字符串）— 要发送的消息（Featuriq 会为每位接收者进行个性化处理）

提示词示例：

• "通知所有请求 CSV 导出的用户，告诉他们该功能现已上线。"
• "告诉为深色模式投过票的用户，我们将在下个迭代开始开发。"

---

create_post

在 Featuriq 看板上创建新的反馈帖子。

参数：

• board_id（string）— 要发布到的看板
• title（string）— 帖子的简短标题
• description（string）— 完整描述

提示词示例：

• “在功能看板上记录一个批量导入 CSV 的功能请求。”
• “为今天与客户通话中提出的 Slack 集成想法创建一个帖子。”

---

可用资源

资源是 AI 可随时读取以获取上下文的数据源。

featuriq://roadmap

按状态分组的当前路线图：进行中、计划中和近期已发布。

提示词示例：

• “我们当前的路线图上有哪些内容？”
• “目前有哪些功能正在开发中？”

featuriq://changelog

最近发布的 20 项功能，包含发布日期和发布说明。

提示词示例：

• “我们最近发布了什么？”
• “撰写一份上个月产品更新的摘要。”

---

对话示例

你： 尚未开始的热门功能请求有哪些？根据投票数和营收影响，我们应该优先处理哪些？

Claude： （调用 get_top_requests 和 get_prioritization） 以下是排名靠前且尚未开始的请求……

你： 很好。将排名第 1 的请求标记为 in_progress，并通知所有为它投票的人。

Claude： （先调用 update_feature_status，再调用 notify_requesters） 完成！状态已更新，并已通知 47 位用户。

---

开发

git clone https://github.com/carlosalvite/featuriq-mcp
cd featuriq-mcp
npm install
npm run build
FEATURIQ_API_KEY=your_key node dist/index.js

开发期间如需监听更改：

npm run dev

---

许可证

MIT © Featuriq