Karakeep书签管理服务

基本能力

产品定位

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进行部署。

安装教程

1. 克隆仓库：
   复制

   git clone <your-repository-url>
   cd hoarder-mcp-server
   

2. 创建虚拟环境（推荐）：
   复制

   python -m venv venv
   source venv/bin/activate  # Windows用户使用`venv\Scripts\activate`
   

3. 安装依赖：
   复制

   pip install -r requirements.txt
   

4. 配置环境变量：
   • 在项目根目录创建.env文件。
   • 添加您的Hoarder API密钥：
     复制

     HOARDER_API_KEY="YOUR_HOARDER_API_KEY_HERE"
     

   • 重要：确保.env在.gitignore中以避免泄露密钥。
5. 本地运行服务器：
   复制

   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"
    // ... 动作特定参数
  }
}