特性库-MCP

Name: 特性库-MCP
Author: marcinwyszynski

作者：marcinwyszynski6 星标更新：2025-06-25

安装使用来源：spider==github.com

项目介绍

Featurebase MCP Server

这是一个提供对Featurebase API访问的Model Context Protocol (MCP)服务器，用于管理帖子和评论。

功能

帖子管理
- 列出带有过滤选项的帖子
- 创建新帖子
- 更新现有帖子
- 删除帖子
- 获取帖子点赞者
- 向帖子添加点赞者
评论管理
- 获取帖子或变更日志的评论
- 创建新的评论或回复
- 更新评论
- 删除评论

安装

从Smithery安装（推荐）

一旦发布到Smithery，用户可以轻松安装该服务器：

npx featurebase-mcp

或者全局安装：

npm install -g featurebase-mcp

从源代码安装

git clone https://github.com/marcinwyszynski/featurebase-mcp.git
cd featurebase-mcp
npm install
npm run build

使用方法

Claude Desktop配置

在你的Claude Desktop配置文件中添加此服务器：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

使用npx（推荐）

{
  "mcpServers": {
    "featurebase": {
      "command": "npx",
      "args": ["featurebase-mcp"],
      "env": {
        "FEATUREBASE_API_KEY": "your-api-key-here",
        "FEATUREBASE_ORG_URL": "https://your-org.featurebase.app"
      }
    }
  }
}

使用全局安装

{
  "mcpServers": {
    "featurebase": {
      "command": "featurebase-mcp",
      "env": {
        "FEATUREBASE_API_KEY": "your-api-key-here",
        "FEATUREBASE_ORG_URL": "https://your-org.featurebase.app"
      }
    }
  }
}

使用本地安装

{
  "mcpServers": {
    "featurebase": {
      "command": "node",
      "args": ["/path/to/featurebase-mcp/build/index.js"],
      "env": {
        "FEATUREBASE_API_KEY": "your-api-key-here",
        "FEATUREBASE_ORG_URL": "https://your-org.featurebase.app"
      }
    }
  }
}

获取API密钥

登录到您的Featurebase帐户
导航到您的帐户设置
生成一个API密钥
保管好它 - 不要将其提交到版本控制系统

环境变量

服务器需要这些环境变量：

必需

FEATUREBASE_API_KEY: 您的FeatureBase API密钥

可选

FEATUREBASE_ORG_URL: 您组织的FeatureBase URL（例如，“https://feedback.spacelift.io”）。仅在使用`resolve_post_slug`工具时需要。
FEATUREBASE_BASE_URL: 自定义API基础URL（默认为“https://do.featurebase.app/v2”）

您可以这样设置它们：

在您的Claude Desktop配置中（推荐）
在您的shell中导出：export FEATUREBASE_API_KEY="your-api-key-here"
运行服务器时：FEATUREBASE_API_KEY="your-api-key-here" npx featurebase-mcp

可用工具

帖子

`list_posts`

列出带有可选过滤条件的帖子。

参数：

id: 根据ID查找特定帖子
q: 根据标题或内容搜索帖子
category: 按板块名称过滤（数组）
status: 按状态ID过滤（数组）
sortBy: 排序顺序（例如，“date:desc”，“upvotes:desc”）
startDate: 发布日期在此日期之后
endDate: 发布日期在此日期之前
limit: 每页结果数
page: 页码

`create_post`

创建新帖子。

参数：

title（必需）: 帖子标题（最少2个字符）
category（必需）: 板块/类别名称
content: 帖子内容
email: 提交者的电子邮件
authorName: 新用户的姓名
tags: 标签名称数组
commentsAllowed: 开启/关闭评论
status: 帖子状态
date: 创建日期
customInputValues: 自定义字段值

`update_post`

更新现有帖子。

参数：

id（必需）: 要更新的帖子ID
title: 新标题
content: 新内容
status: 新状态
commentsAllowed: 开启/关闭评论
category: 新类别
sendStatusUpdateEmail: 向点赞者发送状态更改通知
tags: 新标签
inReview: 将帖子放入审核
date: 创建日期
customInputValues: 自定义字段值

`delete_post`

永久删除帖子。

参数：

id（必需）: 要删除的帖子ID

`get_post_upvoters`

获取点赞了帖子的用户列表。

参数：

submissionId（必需）: 帖子ID
page: 页码（默认：1）
limit: 每页结果数（默认：1 10，最大：100）

`add_upvoter`

向帖子添加点赞者。

参数：

id（必需）: 帖子ID
email（必需）: 点赞者的电子邮件
name（必需）: 点赞者的姓名

`resolve_post_slug`

将帖子别名转换为帖子ID并获取完整的帖子详情。

参数：

slug（必需）: 帖子别名（例如，“spacectl-stack-local-preview-target”）

返回完整的帖子数据，包括ID、标题、内容和元数据。

`get_similar_submissions`

根据给定的查询文本找到相似的帖子。

参数：

query（必需）: 搜索查询文本以找到相似的提交
locale: 搜索的语言环境（默认：“en”）

基于内容相似性返回一系列相似的帖子。

`get_comments`

获取帖子或变更日志的评论。

参数：

submissionId: 帖子ID或别名（如果无changelogId则必需）
changelogId: 变更日志ID或别名（如果无submissionId则必需）
privacy: 按隐私过滤（“public”，“private”，“all”）
inReview: 过滤处于审核中的评论
commentThreadId: 获取线程中的所有评论
limit: 每页结果数（默认：10）
page: 页码（默认：1）
sortBy: 排序顺序（“best”，“top”，“new”，“old”）

`create_comment`

创建新的评论或回复。

参数：

content（必需）: 评论内容
submissionId: 帖子ID或别名（如果无changelogId则必需）
changelogId: 变更日志ID或别名（如果无submissionId则必需）
parentCommentId: 回复的父评论ID
isPrivate: 将评论设为私有（仅管理员）
sendNotification: 通知投票者（默认：true）
createdAt: 设置创建日期
author: 作为特定用户发布（对象包含姓名、电子邮件、头像）

`update_comment`

更新现有评论。

参数：

id（必需）: 评论ID
content: 新内容
isPrivate: 设为私有（仅管理员）
pinned: 将评论置顶
inReview: 将评论放入审核
createdAt: 更新创建日期

`delete_comment`

删除评论（如果有回复，则软删除）。

参数：

id（必需）: 要删除的评论ID

开发

# 安装依赖
npm install

# 构建TypeScript
npm run build

# 在开发模式下运行
npm run dev

安全

绝不要硬编码您的API密钥
总是使用环境变量来存储API密钥
保管好您的API密钥，并定期更换
如果没有有效的FEATUREBASE_API_KEY环境变量，服务器将无法启动

发布

此服务器可在以下位置获得：

Smithery - MCP服务器注册表
npm - Node包管理器

有关发布说明，请参阅PUBLISHING.md。

贡献

欢迎贡献！请随时提交Pull Request。

许可证

MIT