内容
# 功能投票 MCP 服务器
一个 MCP 服务器，用于连接 [功能投票](https://features.vote) 到 AI 助手，如 Claude — 通过自然语言管理功能请求、发布、投票者、评论和更新日志。
## 先决条件
- 在 **成长** 或 **VIP** 计划上的功能投票账户
- 从项目仪表盘中的 **设置 > API 密钥** 来的 API 密钥
- Node.js 18+
## 快速开始
### Claude 桌面版
添加到您的配置文件中：
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"featuresvote": {
"command": "npx",
"args": ["-y", "@features-vote/mcp-server"],
"env": {
"FEATURESVOTE_API_KEY": "fv_live_您的密钥_在此"
}
}
}
}
```
### Claude 代码
```bash
claude mcp add featuresvote -e FEATURESVOTE_API_KEY=fv_live_您的密钥_在此 -- npx -y @features-vote/mcp-server
```
### 光标
添加到 `.cursor/mcp.json` 中：
```json
{
"mcpServers": {
"featuresvote": {
"command": "npx",
"args": ["-y", "@features-vote/mcp-server"],
"env": {
"FEATURESVOTE_API_KEY": "fv_live_您的密钥_在此"
}
}
}
}
```
## 可用工具
### 功能
| 工具 | 描述 |
|------|-------------|
| `list_features` | 列出功能，并可按状态、标签、搜索和分页进行筛选 |
| `create_feature` | 创建新的功能请求 |
| `get_feature` | 通过 ID 获取单个功能 |
| `update_feature` | 更新功能标题、描述、状态或标签 |
| `update_feature_status` | 仅更新功能状态 |
| `delete_feature` | 删除功能 |
| `merge_features` | 合并两个功能（源投票者/标签移动到目标） |
| `link_feature_to_release` | 将功能链接到发布 |
### 投票者
| 工具 | 描述 |
|------|-------------|
| `list_voters` | 列出某个功能的所有投票者 |
| `add_voter` | 将投票者添加到功能（现有用户或新用户） |
### 评论
| 工具 | 描述 |
|------|-------------|
| `list_comments` | 列出某个功能的所有评论 |
| `create_comment` | 在功能上创建评论或内部备注 |
| `update_comment` | 更新评论 |
| `delete_comment` | 删除评论 |
### 发布
| 工具 | 描述 |
|------|-------------|
| `list_releases` | 列出所有发布 |
| `create_release` | 创建发布，可选链接功能 |
| `get_release` | 通过 ID 获取单个发布 |
| `update_release` | 更新发布字段和链接功能 |
| `delete_release` | 删除发布 |
| `send_changelog_email` | 向订阅者发送更新日志邮件（最多 50 个） |
| `generate_changelog` | 从链接功能中 AI 生成更新日志（每天 5 个限制） |
### 项目
| 工具 | 描述 |
|------|-------------|
| `get_project` | 获取 API 密钥的项目详细信息 |
| `get_project_stats` | 获取使用情况统计：投票数、功能、浏览量、发布 |
## 示例提示
配置完成后，尝试询问您的 AI 助手：
- "列出所有待处理的功能请求"
- "创建一个名为 '暗黑模式支持' 的功能，标签为 'UI'"
- "给我看功能 X 的投票者"
- "创建一个发布 v2.1.0 并链接已完成的功能"
- "为最新发布生成更新日志"
- "我的项目统计数据是什么？"
## 配置
| 环境变量 | 是否必需 | 默认值 | 描述 |
|---------------------|----------|---------|-------------|
| `FEATURESVOTE_API_KEY` | 是 | — | 您的 API 密钥 (`fv_live_...`) |
| `FEATURESVOTE_BASE_URL` | 否 | `https://features.vote/api` | 本地/预发布环境覆盖 |
## API 文档
完整的 REST API 文档可在 [features.vote/docs/api](https://features.vote/docs/api) 上找到。
## 本地开发
```bash
git clone https://github.com/featuresvote/featuresvote-mcp.git
cd featuresvote-mcp
npm install
npm run build
```
在开发服务器上进行本地测试：
```bash
FEATURESVOTE_API_KEY=fv_live_xxx \
FEATURESVOTE_BASE_URL=http://localhost:3000/api \
node dist/index.js
```
使用 MCP 检查器进行交互式测试：
```bash
FEATURESVOTE_API_KEY=fv_live_xxx npx @modelcontextprotocol/inspector node dist/index.js
```
## 许可证
MIT
