Barevalue MCP

基本价值mcp

MCP（模型上下文协议）服务器 裸值 人工智能播客编辑API。允许Claude Code和其他MCP兼容工具以编程方式提交和管理播客编辑订单。

特性

• 上传音频文件 直接从本地计算机
• 提交订单 用于人工智能播客编辑
• 检查订单状态 并下载已完成的文件
• 管理webhooks 用于自动通知
• 预验证URL 在提交之前及早发现问题

先决条件

您需要一个Barevance帐户 通过MCP提交订单。这个 基本计划是免费的 包括每月的会议记录和订单。付费计划（Starter、Creator、Pro）包括更多分钟、更多订单和其他功能。

订单使用您的订阅分钟数。如果您的帐户没有足够的分钟数，提交将失败 insufficient_credits 错误。

开始：

• 免费注册 barevaluate.com/register
• 或在以下网址查看平面图 barevance.com/pricing

安装

选项1:npx（推荐）

无需安装。配置Claude代码以通过npx运行：

{
  "mcpServers": {
    "barevalue": {
      "command": "npx",
      "args": ["-y", "barevalue-mcp"],
      "env": {
        "BAREVALUE_API_KEY": "bv_sk_your_api_key_here"
      }
    }
  }
}

选项2：全局安装

npm install -g barevalue-mcp

然后配置克劳德代码：

{
  "mcpServers": {
    "barevalue": {
      "command": "barevalue-mcp",
      "env": {
        "BAREVALUE_API_KEY": "bv_sk_your_api_key_here"
      }
    }
  }
}

配置

获取API密钥

1. 登录到您的 裸值账户
2. 导航至 设置 → API密钥
3. 点击 创建API密钥
4. 复制密钥（以开头 bv_sk_)--只显示一次！

Claude代码设置

添加到您的Claude Code设置文件(~/.claude/settings.json):

{
  "mcpServers": {
    "barevalue": {
      "command": "npx",
      "args": ["-y", "barevalue-mcp"],
      "env": {
        "BAREVALUE_API_KEY": "bv_sk_your_api_key_here"
      }
    }
  }
}

环境变量

可用工具

账户和账单

barevalue_account

获取账户信息，包括信用余额、AI订阅状态和定价。

barevalue_account

barevalue_estimate

在提交之前计算订单的成本。

barevalue_estimate duration_minutes=45

订单工作流

barevalue_upload

从本地计算机上载音频文件。退货 order_id 和 s3_key 提交。

barevalue_upload file_path="/path/to/episode.mp3"

支持的格式： mp3、wav、m4a、flac、aac、ogg 最大文件大小： 750 MB

barevalue_validate

在提交之前，请预先检查来自公共URL的文件。验证语音内容（至少10%）并检测仅包含音乐的内容。不收取学分。

注： 这仅适用于外部URL。通过上传的文件 barevalue_upload 不需要验证-直接转到 barevalue_submit.

barevalue_validate file_url="https://example.com/episode.mp3"

barevalue_submit

提交上传的文件进行人工智能编辑。收取积分/订阅分钟数。

barevalue_submit \
  order_id=12345 \
  s3_key="123/12345/raw/episode.mp3" \
  podcast_name="My Podcast" \
  episode_name="Episode 42: The Answer" \
  processing_style="standard"

可选参数：

• episode_number -组织的剧集编号
• special_instructions -自定义编辑说明（最多2000个字符）
• processing_style - standard | minimal | aggressive
• host_names -转录说话者标签的主机名数组
• guest_names -用于记录演讲者标签的客人姓名数组

barevalue_submit_url

使用公共URL提交，而不是上传。

barevalue_submit_url \
  file_url="https://example.com/episode.mp3" \
  podcast_name="My Podcast" \
  episode_name="Episode 42"

barevalue_status

检查订单状态。完成后返回下载URL。

barevalue_status order_id=12345

状态： pending, downloading, processing, transcribing, editing, completed, failed, refunded

barevalue_list_orders

按页码列出最近的订单。

barevalue_list_orders page=1 per_page=20 status="completed"

网络钩子

barevalue_webhooks_list

列出所有已配置的Webhook。

barevalue_webhook_create

创建一个webhook。 保存这个秘密——它只显示一次！

barevalue_webhook_create \
  url="https://your-server.com/webhook" \
  events=["order.completed", "order.failed"]

可用事件： order.completed, order.failed, order.refunded

barevalue_webhook_update

更新webhook URL、事件或活动状态。

barevalue_webhook_update webhook_id=1 is_active=false

barevalue_webhook_delete

永久删除webhook。

barevalue_webhook_delete webhook_id=1

barevalue_webhook_rotate_secret

生成新的签名密钥。老秘密立刻失效了。

barevalue_webhook_rotate_secret webhook_id=1

使用示例

完整工作流（本地文件）

以下是上传本地文件的典型工作流程：

User: Upload and edit my podcast episode at /Users/me/recording.mp3

Claude: I'll help you submit that podcast episode for editing.

1. First, let me check your account balance...
   [calls barevalue_account]
   You have 120 AI minutes remaining on your subscription.

2. Uploading the file...
   [calls barevalue_upload file_path="/Users/me/recording.mp3"]
   Upload complete. Order ID: 12345

3. Submitting for editing...
   [calls barevalue_submit order_id=12345 s3_key="..." podcast_name="My Show" episode_name="Episode 1"]
   Order submitted! Estimated completion: 15 minutes.

4. I'll check the status...
   [calls barevalue_status order_id=12345]
   Status: completed

   Download links:
   - Edited audio: https://...
   - Transcript PDF: https://...
   - Show notes: https://...

完整工作流（外部URL）

对于已在线托管的文件，您可以在提交前进行验证：

User: Edit this podcast: https://example.com/episode.mp3

Claude: I'll validate and submit that for editing.

1. Checking your account...
   [calls barevalue_account]
   You have 50 AI bonus minutes available.

2. Validating the file...
   [calls barevalue_validate file_url="https://example.com/episode.mp3"]
   ✓ Speech detected: 87%
   ✓ No music-only content detected
   Duration: 32 minutes

3. Submitting for editing...
   [calls barevalue_submit_url file_url="..." podcast_name="My Show" episode_name="Episode 5"]
   Order submitted! Order ID: 12346

检查多个订单

User: What's the status of my recent orders?

Claude: [calls barevalue_list_orders per_page=5]

Here are your recent orders:
| Order ID | Episode | Status | Created |
|----------|---------|--------|---------|
| 12345 | Episode 42 | completed | 2 hours ago |
| 12344 | Episode 41 | completed | yesterday |
| 12343 | Episode 40 | processing | just now |

错误处理

服务器返回结构化错误：

{
  "error": "insufficient_credits",
  "message": "Not enough credits. Need $3.15, have $2.00",
  "statusCode": 402
}

常见错误：

定价

MCP订单使用您的订阅分钟数，与您在barevaluate.com上使用的余额相同 基本计划是免费的 包括每月的会议记录和订单。付费计划包括更多分钟、订单和功能。

每份订单都包含哪些内容：

• 已编辑的音频文件（删除填充词、长停顿、错误开头）
• 成绩单（PDF和DOCX）
• 显示带有时间戳的笔记
• 社交媒体剪辑（人工智能精选亮点）

使用 barevalue_estimate 在提交之前检查您的可用分钟数。查看平面图 barevance.com/pricing.

速率限制

• 每分钟10个请求 每个API密钥
• 文件上传有5分钟的超时时间
• 订单处理通常在10-30分钟内完成

安全

• API密钥通过环境变量传输，从不硬编码
• 所有API通信都使用HTTPS
• Webhook签名使用HMAC-SHA256进行验证
• 预先签名的S3 URL将在30分钟后过期

发展

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

支持

• 文档： https://barevalue.com/docs/api-v1
• 电子邮件： support@barevalue.com

许可证

麻省理工学院