Raindrop.io MCP Server

Raindrop.io のブックマークを操作する Model Context Protocol (MCP) サーバー。Go で実装。

提供ツール

ブックマーク

コレクション

セットアップ

前提条件

• Raindrop.io のテストトークン

インストール

インストールスクリプト（~/.local/bin/ に配置）:

curl -fsSL https://raw.githubusercontent.com/nnno/my-raindrop-io-mcp-server/main/install.sh | sh

Go ユーザーの場合（Go 1.25+ が必要）:

go install github.com/nnno/my-raindrop-io-mcp-server@latest

ソースからビルドする場合（Go 1.25+ が必要）:

make install

MCP クライアントへの設定

Claude Desktop (claude_desktop_config.json) の場合:

{
  "mcpServers": {
    "raindrop": {
      "command": "~/.local/bin/my-raindrop-io-mcp-server",
      "env": {
        "RAINDROP_TOKEN": "your-test-token"
      }
    }
  }
}

Claude Code の場合:

claude mcp add raindrop ~/.local/bin/my-raindrop-io-mcp-server -e RAINDROP_TOKEN=your-test-token

アーキテクチャ

DDD ベースのレイヤードアーキテクチャを採用。

main.go                          # エントリポイント（DI・stdio 起動）
internal/
├── domain/
│   ├── entity/                  # Bookmark, Collection, DomainError
│   └── repository/              # インターフェース定義
│       └── mock/                # mockgen 生成モック
├── application/
│   └── usecase/                 # バリデーション・ビジネスロジック
├── infra/
│   └── raindrop/                # Raindrop.io REST API クライアント
└── handler/                     # MCP ツール登録・リクエスト変換

依存方向: handler → usecase → (domain/entity + domain/repository) ← infra/raindrop

開発

make build       # ビルド（バージョン情報を埋め込み）
make test        # テスト
make test-race   # テスト（レース検出付き）
make lint        # リント
make mock        # モック再生成

ライセンス

MIT