Raindrop.io MCP サーバー

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

特徴

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

前提条件

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でリソースとツールの定義を確認してください。

MCP構成

AI アシスタントまたは MCP 互換クライアントで Raindrop MCP サーバーを使用するには、 .mcp.jsonファイルに次の構成を追加します。

"raindrop": {
  "command": "npx",
  "args": [
    "@adeze/raindrop-mcp"
  ],
  "env": {
    "RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_API_TOKEN"
  }
}

Claude Code またはその他の MCP 互換クライアントの場合、これにより Raindrop サーバーが「raindrop」という名前で登録され、そのすべてのリソースとツールが AI アシスタントで使用できるようになります。

発達

テスト： bun test
型チェック: bun run type-check
ビルド: bun run build
開発: bun run dev
デバッグ: bun run debugまたはbun run inspector
HTTPサーバー: bun run start:http

貢献

貢献を歓迎します！問題を報告したり、プルリクエストを送信してください。

ライセンス

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

Raindrop.io