Karakeep (Hoarder) MCP サーバー

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

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

特徴

• **ブックマークの検索:**クエリ文字列に基づいて、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）：