Maccy Clipboard MCP

🚀 Maccy Clipboard MCP Server

Maccyのクリップボード履歴をClaudeや他のAIアシスタントに公開するMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

このMCPサーバーを使用することで、Claudeを通じてMaccyのクリップボード履歴を検索、取得、管理することができます。

⚠️ 重要なセキュリティ警告

⚠️ 重要提示

このツールはClaudeにあなたの全クリップボード履歴へのアクセスを提供します。この履歴にはパスワード、APIキー、個人情報、機密コンテンツなどの機密情報が含まれている可能性があります。外部のAIシステムに接続すると、これらのデータがローカルマシンの外部に送信される可能性があります。このMCPサーバーを使用することで、あなたはデータ露出やセキュリティリスクに対して全責任を負うことを承認します。著者は、このツールの使用によって生じる不正アクセス、データ漏洩、セキュリティ侵害に対して一切の責任を負いません。自己責任で使用してください。インストール前にセキュリティ要件を十分に検討してください。

✨ 主な機能

• 🔍 テキストパターンでクリップボード履歴を検索
• 📋 最近のクリップボードアイテムを完全な内容で取得
• 🖼️ 画像サポート - クリップボード履歴から画像を表示
• 📌 重要なアイテムをピン留め/ピン留め解除
• 📊 クリップボードの使用統計を表示
• 🗂️ アプリケーションでフィルタリング
• 📁 履歴をJSON/CSV/TXT形式でエクスポート

📦 インストール

簡単インストール (推奨)

1. このリポジトリからmaccy-clipboard-mcp.dxtファイルをダウンロードします。
2. .dxtファイルをダブルクリックしてClaude Desktopで開きます。
3. Claude Desktopが自動的にMCPサーバーをインストールし、設定します。
4. Claude Desktopを再起動します。

手動インストール

.dxtインストールで問題が発生した場合：

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

git clone <repository-url>
cd maccy-clipboard-mcp

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

npm install

3. Claude Desktopの設定ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) に追加します：

{
  "mcpServers": {
    "maccy-clipboard": {
      "command": "node",
      "args": ["/path/to/maccy-clipboard-mcp/server/index.js"]
    }
  }
}

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

トラブルシューティング

拡張機能の読み込みやNode.js関連の問題が発生した場合：

必要なNode.jsの設定 (問題が発生した場合)

⚠️ 拡張機能が読み込めない場合、Claude Desktopの組み込みNode.jsを無効にしてみてください。

1. Node.js LTSをインストールする：nodejs.orgにアクセスし、LTSバージョンをダウンロードします。
2. Claude Desktopを設定する：
   • Claude > 設定 > 拡張機能 > 詳細設定に移動します。
   • "Use Built-in Node.js for MCP"を無効にします。
   • Claude Desktopを再起動します。

一部のユーザーは、Claudeの組み込みバージョンではなく、システムのNode.jsインストールを使用する必要がある場合があります。

追加のトラブルシューティング手順

依然として問題が発生する場合：

1. Node.jsがインストールされていることを確認します。ターミナルでnode --versionを実行します。
2. Claude Desktopの設定で"Use Built-in Node.js for MCP"が無効になっていることを確認します。
3. Claude Desktopを完全に再起動します。
4. ~/Library/Logs/Claude/ (macOS) または %LOCALAPPDATA%\Claude\Logs\ (Windows) のログを確認して、MCPサーバーのエラー詳細を確認します。

💻 使用例

基本的な使用法

利用可能なツールを使用して、クリップボード履歴を操作できます。例えば、以下のように使用できます。

1. search_clipboard - フィルター付きでテキストパターンで検索
2. get_recent_items - 画像サポート付きで最近のアイテムを取得（デフォルトで画像が表示されます）
3. copy_to_clipboard - アイテムをクリップボードにコピー（テキストと画像の両方をサポート）
4. pin_item / unpin_item - ピン留めされたアイテムを管理
5. export_history - ローカルファイルにエクスポート
6. get_clipboard_stats - 使用統計を表示
7. get_items_by_app - 画像サポート付きでアプリケーションでフィルタリング

高度な使用法

画像サポートに関する機能を利用することができます。 サーバーはクリップボード履歴から自動的に画像を検出し、返します。

• 最近のアイテムや検索では、デフォルトで画像が表示されます。
• 画像は、サムネイルサイズ（幅100px）でBase64エンコードされたデータとして返されます。
• PNG、JPEG、TIFFなどの一般的な形式をサポートします。
• 画像は 🖼️ インジケーターでマークされます。
• テキストと画像の両方のコンテンツをクリップボードにコピーできます。

📚 ドキュメント

Maccyについて

Maccy は、macOS用の軽量クリップボードマネージャーで、コピーしたすべての内容の履歴を保持します。メニューバーで実行され、クリップボードアイテムをSQLiteデータベースにローカルに保存します。このMCPサーバーは、そのデータベースに直接接続して、Claudeにクリップボード履歴へのアクセスを提供し、自然な会話を通じてコピーしたコンテンツを検索、取得、管理できるようにします。

注意事項

• すべてのデータはあなたのマシンにローカルに保存されます。
• サーバーはデフォルトで読み取り専用アクセスです（ピン留め/ピン留め解除操作を除く）。
• 大規模なエクスポートは、MCPのサイズ制限を回避するためにローカルファイルに書き込まれます。