精装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作为传输协议
用法
- 从获取API密钥https://hardcover.app/account/api.精确复制提供的值（它已经以开头
Bearer). - 将其导出到服务器：
export HARDCOVER_API_KEY="Bearer "直接运行服务器
- 启动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传输问题：请检查本地网络/代理设置，然后使用稳定的连接重试。