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 进行部署。
设置和本地开发
克隆存储库:
git clone <your-repository-url> cd hoarder-mcp-server创建虚拟环境(推荐):
python -m venv venv source venv/bin/activate # On Windows use `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
标志会自动重启服务器。
API 使用
服务器公开一个 POST 端点: /mcp
。
请求正文 (JSON):
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
在 Karakeep (Hoarder) 中搜索并创建书签。
Related MCP Servers
- -securityAlicense-qualityProvides a note storage system with a custom URI scheme and includes tools for adding notes and generating summaries for Tuya devices.Last updated -2MIT License
- -securityAlicense-qualityA very simple vector store that provides capability to watch a list of directories, and automatically index all the markdown, html and text files in the directory to a vector store to enhance context.Last updated -1031MIT License
- AsecurityFlicenseAqualityThis server enables users to store, manage, and summarize notes using a custom URI scheme, with functionality to add new notes and generate summaries with varying levels of detail.Last updated -3
- AsecurityFlicenseAqualityAllows you to search the web using DuckDuckGo and optionally fetch and summarize content from search results.Last updated -23