Raindrop MCP サーバー

これは、Python MCP SDKを搭載したRaindrop.io用のモデルコンテキストプロトコル（MCP）サーバーです。Claude DesktopからRaindropコレクション、レインドロップ、タグを、シンプルで人間らしい言語で簡単に読み込み、更新できます。Firecrawl MCPサーバーなどと組み合わせることで、Raindropコレクションとタグ付けシステムの自動化と整理を効率化できます。

要件

Python 3.12以上
UVパッケージマネージャー
クロードデスクトップ
Raindrop.ioアカウントとAPIトークン

設定

1. Raindrop APIトークンを取得する

Raindrop.io開発者ポータルへ
新しいアプリを作成する
APIトークンをコピーする

2. APIトークンを設定する

Raindrop API トークンを環境変数として設定します。

ルートディレクトリに.envファイルを作成する
新しい行を追加します: RAINDROP_TOKEN="your_token_here"

発達

サーバーを開発モードで実行するには:

uv run mcp dev server.py

インストール

Claude Desktop にサーバーをインストールするには:

uv run mcp install server.py

これにより、サーバーがローカルで起動し、変更をテストできるようになります。

特徴

サーバーは以下を提供します:

機能を通じてRaindropコレクションとRaindropデータにアクセスする
ルートコレクション、子コレクション、またはIDによる特定のコレクションの表示をサポート
コレクションとレインドロップを作成、更新、削除するためのツール
新しいタグを作成および更新するためのツール

ツール

サーバーは、Claude Desktop が Raindrop コレクションに対してアクションを実行できるようにする次の MCP ツールを提供します。

コレクションの作成

Raindrop.io に新しいコレクションを作成します。

パラメータ:

title （必須）: コレクションの名前
view : ビューの種類 (リスト、グリッド、メイソンリー、シンプル)
public : コレクションが公開されているかどうか
parent_id : 親コレクションのID（ルートコレクションの場合は省略）

更新コレクション

Raindrop.io 内の既存のコレクションを更新します。

パラメータ:

collection_id (必須): 更新するコレクションのID
title : コレクションの新しい名前
view : ビューの種類 (リスト、グリッド、メイソンリー、シンプル)
public : コレクションが公開されているかどうか
parent_id : 親コレクションのID（ルートコレクションの場合は省略）
expanded : コレクションが展開されているかどうか

コレクションの削除

Raindrop.ioからコレクションを削除します。レインドロップはゴミ箱に移動されます。

パラメータ:

collection_id (必須): 削除するコレクションのID

ゴミ箱を空にする

Raindrop.io のゴミ箱を空にして、そこにあるすべてのレインドロップを完全に削除します。

get_raindrop

ID により Raindrop.io から単一の雨滴を取得します。

パラメータ:

raindrop_id (必須): 取得する雨滴のID

get_raindrops

Raindrop.io コレクションから複数の雨滴を取得します。

パラメータ:

collection_id (必須): レインドロップを取得するコレクションのID。すべてのレインドロップを取得する場合は0、未ソートの場合は-1、ゴミの場合は-99を指定します。
search : オプションの検索クエリ
sort : ソート順 (オプション: -created、created、score、-sort、title、-title、domain、-domain)
page : ページ番号（0から始まる）
perpage : ページあたりの項目数（最大 50）
nested : ネストされたコレクションからの雨滴を含めるかどうか

タグを取得する

Raindrop.io からタグを取得します。

パラメータ:

collection_id : タグを取得するコレクションのID（オプション）。指定しない場合は、すべてのコレクションのすべてのタグが取得されます。

更新_雨滴

Raindrop.io 内の既存のレインドロップ (ブックマーク) を更新します。

パラメータ:

raindrop_id (必須): 更新するレインドロップのID
title ：雨滴の新しいタイトル
excerpt ：新しい説明/抜粋
link : 新しいURL
important : お気に入りとしてマークするにはTrueに設定します
tags : 割り当てるタグのリスト
collection_id : 雨滴を移動するコレクションのID
cover : カバー画像のURL
type : 雨滴の種類
order : ソート順（昇順） - 0に設定すると最初の場所に移動します
pleaseParse : Trueに設定すると、メタデータ（カバー、タイプ）をバックグラウンドで再解析します。

多数の雨滴を更新

コレクション内の複数のレインドロップを一度に更新します。

パラメータ:

collection_id (必須): 更新する雨滴を含むコレクションのID
ids : 更新する特定のレインドロップIDのオプションリスト
important : お気に入りとしてマークするにはTrueに設定し、マークを解除するにはFalseに設定します
tags : 追加するタグのリスト（すべてのタグを削除する場合は空のリスト）
cover : カバー画像のURL（すべてのスクリーンショットを設定するには「''」を使用）
target_collection_id : 雨滴を移動するコレクションのID
nested : ネストされたコレクションから雨滴を含める
search : 更新する雨滴をフィルタリングするためのオプションの検索クエリ

クエリの例

サーバーを Claude Desktop にインストールした後、次のような質問やコマンドを Claude に尋ねることができます。

「レインドロップコレクションをすべて見せてください」
「プログラミング関連のコレクションはありますか？」
「このコレクション内のすべての雨滴にこのタグを追加します」
「ID 12345のRaindropコレクションの詳細を表示してください」
「Raindrop にはどのような子コレクションがありますか?」
「「Claude Resources」という新しいRaindropコレクションを作成します」

依存関係

依存関係についてはpyproject.toml参照してください。

これらはuv run mcp installまたはuv run mcp dev使用すると自動的にインストールされます。

貢献

貢献を歓迎します！このプロジェクトに貢献する方法は次のとおりです。

リポジトリをフォークする
新しいブランチを作成します（ git checkout -b feature/your-feature-name ）
変更を加える
意図したとおりに動作するか検証する
変更をコミットします（ git commit -m 'Add some feature' ）
ブランチにプッシュします ( git push origin feature/your-feature-name )
プルリクエストを開く

コードが既存のスタイルに従っており、適切なドキュメントが含まれていることを確認してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。詳細については、 LICENSE.txtファイルを参照してください。