Raindrop.io

🚀 Raindrop.io MCP サーバー（Go）

このプロジェクトは、大規模言語モデル（LLM）がモデルコンテキストプロトコル（Model Context Protocol, MCP）を介してRaindrop.ioのブックマークとやり取りできるようにする統合機能を、Go言語で実装したものです。

🚀 クイックスタート

このサーバーを使用することで、大規模言語モデルがRaindrop.ioのブックマークとやり取りできるようになります。以下の手順に従ってセットアップしてください。

✨ 主な機能

• ブックマークの作成
• ブックマークの検索
• タグによるフィルタリング

📦 インストール

必要条件

• Go 1.20 以上
• Raindrop.io アカウントと API トークン

インストール手順

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

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

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

go mod tidy

3. 環境変数を設定します：

• .env ファイルを作成し、Raindrop.io API トークンを設定します。

RAINDROP_TOKEN=your_access_token_here

4. ビルドします：

go build -o raindrop-mcp-server

💻 使用例

Claude Desktop との連携

1. Claude Desktop の設定ファイルを開きます：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 以下の設定を追加します：

{
  "mcpServers": {
    "raindrop": {
      "command": "/path/to/raindrop-mcp-server",
      "env": {
        "RAINDROP_TOKEN": "your_access_token_here"
      }
    }
  }
}

3. Claude Desktop を再起動します。

利用可能なツール

create-bookmark

新しいブックマークを作成します。

パラメータ:

• url：ブックマークする URL（必須）
• title：ブックマークのタイトル（任意）
• tags：タグの配列（任意）
• collection：コレクション ID（任意）

search-bookmarks

ブックマークを検索します。

パラメータ:

• query：検索クエリ（必須）
• tags：フィルタリングするタグの配列（任意）

開発

# ビルド
go build -o raindrop-mcp-server

# 実行
./raindrop-mcp-server

🔧 技術詳細

このサーバーは、Go言語で実装されており、Raindrop.io API を使用してブックマークとのやり取りを行います。環境変数を使用して API トークンを管理することで、セキュリティを確保しています。

⚠️ 重要提示

• APIトークンは常に環境変数を使用して管理してください。
• Claude Desktopの設定ファイルに適切な権限を設定してください。
• 不要なファイルアクセスを制限してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

Copyright © 2024 貢献者

このソフトウェアおよび関連ドキュメントファイル（「ソフトウェア」）のコピーを無料で取得することが許可され、ソフトウェアを制限なく取り扱うことができます。これには、使用、コピー、修正、統合、公開、配布、再ライセンス付与、および/または販売する権利が含まれます。また、ソフトウェアを提供する個人に対しても同様の取り扱いが許可されます。

ソフトウェアは「現状のまま」提供され、適銷性、特定の目的への適合性、および非侵害性に関する明示または暗示の保証を含む、いかなる保証も行われません。契約、過失、またはその他の行為に起因するいかなる請求、損害、またはその他の責任についても、著者または著作権所有者は一切の責任を負いません。

🤝 貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. プルリクエストを作成します。

🔗 関連リンク

• モデルコンテキストプロトコル
• Raindrop.io API ドキュメント
• Go MCP ライブラリ