Skip to main content
Glama

Karakeep MCP Server

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):

{ "action": "action_name", "parameters": { "param1": "value1", "param2": "value2" // ... action-specific parameters } }
-
security - not tested
A
license - permissive license
-
quality - not tested

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) 中搜索并创建书签。

  1. 特征
    1. 先决条件
      1. 设置和本地开发
        1. API 使用

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            Provides a note storage system with a custom URI scheme and includes tools for adding notes and generating summaries for Tuya devices.
            Last updated -
            1
            Python
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            A 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 -
            123
            16
            TypeScript
            MIT License
          • A
            security
            F
            license
            A
            quality
            This 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
            Python
            • Apple
          • -
            security
            -
            license
            -
            quality
            Allows you to search the web using DuckDuckGo and optionally fetch and summarize content from search results.
            Last updated -
            Python

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/jcrabapple/hoarder-mcp-server'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server