Readeck MCP

重新检查mcp

用于自托管的MCP（模型上下文协议）服务器 重新检查 例子

此服务器将Readeck公开为MCP 工具 和 资源 因此，AI客户端（ChatGPT/Codex/代理运行时）可以：

• 搜索文章/书签
• 按标题、全文、标签筛选
• 默认情况下排除存档项目（可选包括/仅存档）
• 存档和非存档文章
• 获取完整内容和亮点作为结构化资源
• 生成引文（Markdown、CSL-JSON、BibTeX）

目标是使Readeck成为人工智能辅助学习的可靠阅读和突出显示后端 工作流程（总结、主动回忆、间隔重复），同时保持MCP服务器专注于 数据访问和规范化。

状态

早期阶段——只有项目框架和规范到位。

• 规格： docs/SPEC.md

需求

• 转到1.22+（推荐）

配置

设置环境变量：

• READECK_BASE_URL --Readeck实例的基本URL，例如。 https://readeck.example.com
• READECK_API_TOKEN -Readeck API令牌（Bearer）
• READECK_TIMEOUT_SECONDS --可选（默认值： 20)
• READECK_USER_AGENT --可选（默认值： readeck-mcp/0.1)
• READECK_VERIFY_TLS --可选（默认值： true)
• MCP_TRANSPORT --可选(stdio 违约； http/streamable-http 用于远程传输）
• MCP_HTTP_ADDR --可选（默认值： 127.0.0.1:8080)
• MCP_HTTP_PATH --可选（默认值： /mcp)
• MCP_HTTP_AUTH_TOKEN --HTTP请求所需的可选承载令牌
• MCP_ALLOWED_ORIGINS --可选逗号分隔的列表 Origin 标题检查

快速开始

go run ./cmd/readeck-mcp

HTTP传输模式：

MCP_TRANSPORT=http MCP_HTTP_ADDR=:8080 MCP_HTTP_PATH=/mcp go run ./cmd/readeck-mcp

项目布局

• cmd/readeck-mcp/ --入口点
• internal/readeck/ --重新检查HTTP客户端和DTO映射
• internal/mcp/ --MCP工具和资源处理程序
• internal/render/ --HTML/文本清理和Markdown渲染
• internal/citation/ --引文格式（Markdown、CSL-JSON、BibTeX）
• internal/config/ --配置解析/验证
• docs/ --规范和文件

______________________________________________________________________

（C） 2026年，安德烈·克里萨诺夫