Hey Bible MCP

@嘿圣经/mcp

用于Hey Bible API的MCP服务器。提供用于搜索圣经经文、浏览翻译以及访问您的收藏夹、笔记、图像、聊天和标签的工具。

安装

npm install -g @hey-bible/mcp

或者直接使用npx运行：

npx @hey-bible/mcp

配置

将Hey Bible API键设置为环境变量：

export HEY_BIBLE_API_KEY=your_api_key_here

从获取API密钥 嘿圣经 在帐户>API密钥下。

使用Claude Desktop

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "hey-bible": {
      "command": "npx",
      "args": ["-y", "@hey-bible/mcp"],
      "env": {
        "HEY_BIBLE_API_KEY": "your_api_key_here"
      }
    }
  }
}

然后重新启动Claude Desktop。

可用工具

get_bibles

获取可用的圣经翻译。

获取_书籍

获取包含3个字母代码和章节数的圣经书籍列表。

search_verses

按书籍和章节搜索圣经经文。将结果保存到用户帐户。

参数：

• book （必填）：书名（例如“约翰”、“创世纪”、“哥林多前书”）
• chapter （必填）：章节编号
• start_verse （可选）：起始诗句编号
• end_verse （可选）：结束诗句编号
• bible_id （可选）：圣经翻译ID（默认为ESV）

获取收藏

通过笔记、图像、对话和标签获取最喜欢的圣经经文。

参数：

• tag （可选）：按标签名称筛选收藏夹
• limit （可选）：要返回的收藏夹数量（1-100）
• offset （可选）：分页时要跳过的收藏夹数量

get_chats

与诗歌背景进行聊天对话。

参数：

• id （可选）：要检索完整消息的特定聊天ID（UUID）
• limit （可选）：要返回的聊天次数（1-100）
• offset （可选）：分页时要跳过的聊天次数

获取标签

获取所有用户定义的标签。标签可用于过滤收藏夹。

get_notes

获取与圣经经文相关的笔记。

参数：

• id （可选）：要检索的特定钞票ID
• limit （可选）：要退回的钞票数量（1-100）
• offset （可选）：分页时要跳过的注释数

获取图片

获取与圣经经文相关的人工智能生成图像。

参数：

• id （可选）：要检索的特定图像ID（返回24小时过期的签名URL）
• limit （可选）：要返回的图像数量（1-100）
• offset （可选）：分页时要跳过的图像数量

发展

# Install dependencies
npm install

# Build
npm run build

# Run locally
HEY_BIBLE_API_KEY=your_key node dist/index.js

释放

发布是通过GitHub Actions自动完成的。当您推送版本标签时，工作流将：

1. 使用自动生成的发布说明创建GitHub版本
2. 使用标签中的版本将包发布到npm

这 package.json 版本不需要手动更新——CI从git标签中提取版本，并在发布前在构建中设置。

# 1. Commit your changes
git add .
git commit -m "feat: description of changes"

# 2. Tag with the new version
git tag v1.1.0

# 3. Push the commit and tag
git push origin main --tags

工作流程处理其余部分。您需要 NPM_TOKEN 在存储库设置中配置的秘密。

许可证

麻省理工学院