Karakeep（Hoarder）MCP 服务器

该项目提供了一个与 Mind Control Panel (MCP) 兼容的服务器，允许通过其 API 与Karakeep书签服务进行交互（搜索和创建书签）。

它旨在供大型语言模型 (LLM) 或其他能够根据Glama.ai等服务定义的 MCP 协议发出 HTTP 请求的客户端使用。

特征

• **搜索书签：**根据查询字符串在 Karakeep 中查找现有书签。
• **创建书签：**使用 URL 和可选标题/描述向 Karakeep 添加新书签。
• **MCP 兼容端点：**为操作公开单个/mcp端点。
• **环境变量配置：**安全地配置您的 Hoarder API 密钥。

先决条件

• 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 # On Windows use `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标志会自动重启服务器。

API 使用

服务器公开一个 POST 端点： /mcp 。

请求正文 (JSON):