Raindrop.io

🚀 Raindrop.io MCP サーバー

このプロジェクトは、Raindrop.io ブックマークサービスとのやり取りを可能にする Model Context Protocol (MCP) サーバーを提供します。言語モデル（LLMs）や他の AI エージェントが MCP 標準を通じて Raindrop.io のデータにアクセスし、管理できるようになります。

✨ 主な機能

• CRUD操作：コレクションとブックマークの作成、読み取り、更新、削除が可能です。
• 高度な検索：タグ、ドメイン、タイプ、作成日などでブックマークをフィルタリングできます。
• タグ管理：タグの一覧表示、名前変更、統合、削除ができます。
• ハイライトアクセス：ブックマーク内のテキストハイライトを取得できます。
• コレクション管理：コレクションの並べ替え、展開/折りたたみ、統合、空のコレクションの削除が可能です。
• ファイルアップロード：直接 Raindrop.io にファイルをアップロードできます。
• リマインダー設定：特定のブックマークにリマインダーを設定できます。
• インポート/エクスポート：ブックマークのインポートとエクスポートの状態を開始し、確認できます。
• ゴミ箱管理：ゴミ箱を空にできます。
• MCP 準拠：MCP リソースとツールを通じて Raindrop.io の機能を公開します。
• ストリーミングサポート：ブックマークの更新をリアルタイムでストリーミングする SSE（サーバー送信イベント）エンドポイントを提供します。
• TypeScript の使用：保守性を向上させるための強い型付けがあります。
• Axios の使用：Raindrop.io API へのリクエストに使用されます。
• Zod の使用：API パラメータとレスポンスの堅牢なスキーマ検証を行います。
• MCP SDK の使用：公式の @modelcontextprotocol/sdk を利用しています。

📦 インストール

前提条件

• Node.js（v18 以上）
• Bun 環境

インストール手順

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/raindrop-mcp-server.git
   cd raindrop-mcp-server
   

2. 依存関係をインストールします：

   npm install または bun add
   

3. 開発サーバーを起動します（オプション）：

   npm run dev または bun run dev
   

4. プロジェクトをビルドします：

   npm run build または bun run build
   

5. テストを実行します：

   npm test または bun test
   

📚 ドキュメント

環境変数

• PORT：サーバーが動作するポートを指定します。デフォルトは 3000 です。
• DEBUG：デバッグモードを有効にするには、値を true に設定します。

リソース URI

以下は MCP サーバーが提供するリソース URI です：

リクエスト例

新しいコレクションを作成する

POST /api/collections
Content-Type: application/json

{
  "name": "私の新しいコレクション",
  "description": "私の最初の MCP コレクション"
}

ブックマークを検索する

GET /api/items?search=技術
HTTP/1.1

🤝 貢献

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

📄 ライセンス

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