Raindrop.io MCP サーバー

Name: Raindrop.io
Author: adeze

このプロジェクトは、 Raindrop.ioブックマークサービスと連携するためのモデルコンテキストプロトコル（MCP）サーバーを提供します。これにより、言語モデル（LLM）やその他のAIエージェントがMCP標準を通じてRaindrop.ioデータにアクセスし、管理できるようになります。

npmバージョン

特徴

CRUD 操作: コレクションとブックマークの作成、読み取り、更新、削除。
詳細検索: タグ、ドメイン、タイプ、作成日などのさまざまな基準でブックマークをフィルタリングします。
タグ管理: タグの一覧表示、名前変更、結合、削除を行います。
ハイライトアクセス: ブックマークからテキストのハイライトを取得します。
コレクション管理: 空のコレクションの並べ替え、展開/折りたたみ、結合、削除を行います。
ファイルのアップロード: Raindrop.io にファイルを直接アップロードします。
リマインダー: 特定のブックマークにリマインダーを設定します。
インポート/エクスポート: ブックマークのインポートとエクスポートを開始し、ステータスを確認します。
ゴミ管理: ゴミを空にします。
MCP コンプライアンス: Raindrop.io 機能を MCP リソースおよびツールとして公開します。
ストリーミングサポート: ブックマークの更新をストリーミングするためのリアルタイム SSE (Server-Sent Events) エンドポイントを提供します。
TypeScript で構築: 強力な型付けにより保守性が向上します。
Axios を使用します: Raindrop.io API へのリクエストを行うため。
Zod を使用します: API パラメータと応答の堅牢なスキーマ検証のため。
MCP SDK を使用: 公式の@modelcontextprotocol/sdkを活用します。

Related MCP server: Weather Service MCP Server

前提条件

Node.js (v18以降を推奨) または Bun
Raindrop.ioアカウント
Raindrop.io API アクセストークン ( Raindrop.io 設定で作成してください)

インストールと使用方法

NPXの使用（推奨）

インストールせずに npx を使用してサーバーを直接実行できます。

# Set your API token as an environment variable export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN # Run the server npx @adeze/raindrop-mcp

ソースから

リポジトリをクローンします。
git clone https://github.com/adeze/raindrop-mcp.git cd raindrop-mcp
依存関係をインストールします:
bun install
**環境変数を構成する:**次の例をコピーして、ルートディレクトリに.envファイルを作成します。
cp .env.example .env
.envファイルを編集し、Raindrop.io API アクセストークンを追加します。
RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
ビルドと実行:
bun run build bun start

サーバーは、デフォルトで通信に標準入出力 (stdio) を使用し、stdin で要求をリッスンして、stdout に応答を送信します。

MCPクライアントでの使用

MCPクライアント（LLMエージェントなど）をstdio経由で実行中のサーバープロセスに接続します。サーバーは以下のリソースURIを公開します。

collections://all - すべてのコレクション
collections://{parentId}/children - 子コレクション
tags://all - すべてのタグ
tags://collection/{collectionId} - コレクションでフィルタリングされたタグ
highlights://all - すべてのハイライト
highlights://raindrop/{raindropId} - 特定のブックマークのハイライト
highlights://collection/{collectionId} - コレクション別にフィルタリングされたハイライト
bookmarks://collection/{collectionId} - コレクション内のブックマーク
bookmarks://raindrop/{id} - IDによる特定のブックマーク
user://info - ユーザー情報
user://stats - ユーザー統計

また、コレクション管理、ブックマーク操作、タグ管理、ハイライト操作、ユーザー操作といった運用タスクのためのツールも多数提供しています。利用可能なツールの詳細なリストについては、 CLAUDE.mdを参照するか、 src/services/mcp.service.tsでリソースとツールの定義を確認してください。