AI导哈

图书数据查询服务

一个提供Hardcover.app GraphQL API只读访问的社区维护服务器，支持书籍、用户和系列数据的查询。

  • by AlexSowT
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 alexsowt/hardcover-mcp

使用说明

精装MCP

模型上下文协议（MCP）服务器，公开对Hardcover.app GraphQL API的只读访问。工具的名称间隔如下 books.*, users.*，以及 series.*，通过资源和提示来指导安全、低容量的查询。

这是一个非官方的、由社区维护的服务器，与Hardcover.app无关。

需求

  • Python 3.11+
  • 来自的硬壳API密钥（只读承载令牌）https://hardcover.app/account/api

安装

# Option A: with uv (recommended)
uv pip install -e .

# Option B: with pip
python -m venv .venv
source .venv/bin/activate
pip install -e .

传输协议

此服务器目前仅支持STDIO作为传输协议

用法

  1. 从获取API密钥https://hardcover.app/account/api.精确复制提供的值（它已经以开头 Bearer ).
  2. 将其导出到服务器：
export HARDCOVER_API_KEY="Bearer <your-token>"

直接运行服务器

  1. 启动MCP服务器：
uv run src/hardcover_mcp/main.py

为AI聊天配置STDIO

法典

[mcp_servers.hardcover_mcp]
command = "uv"
args = ["run", "src/hardcover_mcp/main.py"]
env = { "HARDCOVER_API_KEY" = "API KEY heRE" }
cwd = "full_path_to/hardcover_mcp"

服务器注册 books.*, users.*，以及 series.* 工具名称空间，以及类似的资源 hardcover/tag-categories 以及使用提示，例如 hardcover/fantasy-this-year.

运行测试套件

pytest

故障排除

  • HARDCOVER_API_KEY environment variable is required：确保变量设置在启动服务器的同一shell中。包括领导 Bearer 前缀。
  • Hardcover API returned an error response 或401/403：确认令牌有效且未过期。
  • 响应缓慢或超时：减少 limit/offset 论据；API强制执行速率限制。从开始 limit<=10.
  • SSL/HTTP传输问题：请检查本地网络/代理设置，然后使用稳定的连接重试。

相关 MCP