Karakeep MCP サーバー

Karakeep (Hoarder) MCP サーバー

このプロジェクトは、API を介してKarakeepブックマークサービスとのやり取り (ブックマークの検索と作成) を可能にする Mind Control Panel (MCP) 互換サーバーを提供します。

これは、 Glama.aiなどのサービスによって定義された MCP プロトコルに従って HTTP リクエストを行うことができる Large Language Models (LLM) またはその他のクライアントによって使用されるように設計されています。

リポジトリをクローンします。
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フラグを指定すると、コードの変更が検出されるとサーバーが自動的に再起動されます。

サーバーは単一の POST エンドポイント/mcpを公開します。

リクエスト本文（JSON）：

{
  "action": "action_name",
  "parameters": {
    "param1": "value1",
    "param2": "value2"
    // ... action-specific parameters
  }
}

security - not tested

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) でブックマークを検索および作成します。