← 返回目录

Bookworm Mcptools

社区

为 BookWorm 提供目录和注册表服务的 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 374 / 438
Stars: ★ 507 非常热门
传输方式: stdio（本地进程）
运行环境: 远程托管（无需本地环境） · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 4 天前

37FMRS · D

该服务器是 BookWorm 演示项目中的 MCP 工具，用于提供目录和注册表服务。它不是官方产品，而是项目中的一部分。虽然它展示了 MCP 在 .NET 微服务中的集成，但由于项目用于演示，不推荐在生产环境使用。

最强项 · 维护活跃度 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

12/20

文档质量

6/20

安装易用性

6/20

查看各项评分依据

可靠性 5/20: 清单结构有效，声明了 streamable-http 远程端点和 OCI stdio 包，catalog/registry 工具的 .NET MCP 场景看似合理。但远程 URL（https://bookworm.com/mcp）是占位域名，清单 subfolder（src/Integrations/BookWorm.McpTools）与给出的服务端路径（src/Services/McpTools/BookWorm.McpTools）不一致，四个环境变量描述完全相同，且未提供覆盖该服务端关键路径的 CI 工作流或已提交测试。静态校准将可靠性上限设为 12，缺少可执行证据只能给低分（5）。
安全与权限 8/20: 未触发任何红线：没有恶意代码、凭据窃取、破坏性操作或安装示例中泄露令牌的证据。清单未将任何 catalog 端点标为机密（对 URL 而言合理）。README 中的 SLSA 2 与 OpenSSF Scorecard 徽章表明对供应链安全的关注。扣分项：工具级最小权限与危险操作确认行为无法从现有材料验证；MCP 服务端与 catalog/registry 服务之间的数据流边界未披露；容器来源仅由徽章宣称，未在提供的文件中得到证明。
维护活跃度 12/20: MIT 许可、仓库未归档，README 展示多条 CI 流水线（backend、frontend、Keycloakify）、SonarCloud 覆盖率、SLSA 2 和 OpenSSF Scorecard 徽章，证明项目处于持续活跃开发。扣分项：64 个未关闭 issue 且响应质量未知，未记录安全响应渠道，提供的证据中看不到发布节奏或变更日志。
文档质量 6/20: README 是很好的项目级概览（架构图、目标清单、本地运行步骤、Azure 部署步骤），清单列出了环境变量。扣分项：缺少针对 MCP 服务端的文档（工具参数、认证、速率限制、成本、故障排查）；声明的工具没有使用示例；环境变量描述是重复的占位文案，反而让配置更困惑。
安装易用性 6/20: OCI stdio 包是看似可行的自包含安装路径，也列出了四个必需变量。但 README 没有记录该安装方式，没有主流客户端配置示例（如 Claude Desktop/VS Code），远程端点指向占位域名，且完整项目引导需要 mise、Docker 和 Aspire CLI。静态校准将 setup 上限设为 15，而这里的缺口将分数降至 6。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

希望在 .NET Aspire 应用程序中集成 MCP 服务器的开发者。
需要标准化 AI 工具接口以与多代理系统协作的团队。

不适合谁

生产环境使用：此项目明确标注为仅供演示，不适用于生产环境。
寻找完整 BookWorm 客户端 UI 的用户，该服务器仅提供后端工具。

所需权限

网络访问：需要访问配置的目录服务端点（CATALOG_HTTP 和 CATALOG_HTTPS）以完成工具调用。

风险与副作用

依赖配置的目录服务可用性，若端点不可达则工具调用会失败。
由于项目是演示性质，可能存在未解决的安全或稳定性问题。
使用 AI 功能时，可能涉及外部 API（如 OpenAI），存在数据外发风险。

安装接入

准备工作

运行环境：远程托管（无需本地环境） · Docker

CATALOG_HTTP 必填目录服务的 HTTP 端点地址，manifest 标记为必填，使用你部署的 BookWorm catalog 服务地址。

CATALOG_HTTPS 必填目录服务的 HTTPS 端点地址，manifest 标记为必填，使用你部署的 BookWorm catalog 服务地址。

根据仓库和服务器清单，该服务器以 OCI 镜像形式分发，可通过 ghcr.io/foxminchan/bookworm/mcptools:1.0.0 获取。运行需要配置环境变量，包括 CATALOG_HTTP、CATALOG_HTTPS、services__catalog__http__0 和 services__catalog__https__0，这些变量用于指定目录服务的 HTTP/HTTPS 端点。有关详细的本地运行和部署步骤，请参阅仓库 README。

验证是否装好

在 MCP 客户端中通过 streamable-http 连接 https://bookworm.com/mcp，查看工具列表中是否出现 catalog 和 registry 相关工具；然后询问目录中的书目以验证响应正常。

常见排障

确保已设置所有必需的环境变量，并检查端点值是否有效。
检查目录服务是否已启动并可从 MCP 服务器网络访问。
确保使用正确版本的 OCI 镜像（1.0.0）并遵循仓库的部署指引。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出 BookWorm 目录里有哪些书
查询某本书的详细信息和库存状态
帮我在 BookWorm 注册服务中查一下可用的服务
比较几本目录中的书籍信息

使用场景

作为开发人员，在开发或演示 BookWorm 应用时，通过 MCP 访问目录和注册表服务。

在 AI 代理工作流中集成 BookWorm 的目录和注册表工具，实现智能化的图书管理。

详细介绍

这是一个 MCP 服务器，为 BookWorm 提供工具，例如目录和注册表服务。BookWorm 是一个演示性的云原生应用程序，使用 Aspire 构建，集成了 AI、微服务、领域驱动设计和多智能体系统。该服务器实现了 MCP 标准化 AI 工具，并支持 A2A 和 AG-UI 协议。