基本能力
产品定位
Karakeep (Hoarder) MCP Server 是一个用于管理Karakeep书签的服务，通过MCP协议提供书签的搜索和创建功能。
核心功能
- 搜索书签：根据查询字符串在Karakeep中查找现有书签。
- 创建书签：向Karakeep添加新书签，包含URL和可选的标题/描述。
- MCP兼容端点：暴露一个单一的
/mcp端点用于操作。 - 环境变量配置：安全配置您的Hoarder API密钥。
适用场景
- 大型语言模型（LLMs）需要访问和管理书签。
- 需要通过MCP协议与Karakeep书签服务交互的客户端。
使用教程
使用依赖
- Python 3.8+
- Karakeep账户和API密钥（参见Karakeep API文档）
- 访问托管平台（如Render, Heroku, Fly.io, VPS）或Docker进行部署。
安装教程
- 克隆仓库：
git clone
cd hoarder-mcp-server- 创建虚拟环境（推荐）：
python -m venv venv
source venv/bin/activate # Windows用户使用`venv\Scripts\activate`- 安装依赖：
pip install -r requirements.txt- 配置环境变量：
- 在项目根目录创建.env文件。 - 添加您的Hoarder API密钥：
HOARDER_API_KEY="YOUR_HOARDER_API_KEY_HERE"- 重要：确保.env在.gitignore中以避免泄露密钥。
- 本地运行服务器：
uvicorn main:app --reload --port 8000服务器将在http://127.0.0.1:8000可用。--reload标志会在代码更改时自动重启服务器。
调试方式
- 访问
http://127.0.0.1:8000/docs查看API文档并进行调试。 - 使用Postman或curl测试
/mcp端点。
API使用
服务器暴露一个POST端点：/mcp。
请求体（JSON）：
{
"action": "action_name",
"parameters": {
"param1": "value1",
"param2": "value2"
// ... 动作特定参数
}
}