Anyboxmcp

🚀 Anybox MCP Server

Anybox は macOS 用のブックマークマネージャーです。このサーバーは、Model Context Protocol (MCP) サーバーで、Claude Desktop やその他の MCP クライアントが Anybox のブックマークとやり取りできるようにします。

✨ 主な機能

• 🔍 キーワード、タグ、フォルダ、またはスター付きの状態でブックマークを検索します。
• 🏷️ ID、名前、およびブックマーク数を含むすべてのタグを一覧表示します。
• 📁 ID、名前、およびブックマーク数を含むすべてのフォルダを一覧表示します。
• ➕ タグ、フォルダ、コメント、およびスター付きの状態で新しいブックマークを保存します。
• 🔗 Claude Desktop との直接統合により、シームレスなブックマーク管理が可能です。

📦 インストール

前提条件

• Anybox がインストールされ、実行されている macOS
• Python 3.10 以上
• Anybox API キー（下記参照）

Anybox API キーの取得方法

1. Anybox を開きます。
2. 設定 → 全般（または 設定 → 一般）に移動します。
3. 表示されている API キーをコピーします。

インストール手順

1. このリポジトリをクローンまたはダウンロードします

cd ~/coding/anyboxTidier

2. 仮想環境を作成し、依存関係をインストールします

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. API キーを設定します API キーは Claude Desktop の設定で設定します（下記参照）。グローバルにエクスポートする必要はありません。

💻 使用例

Claude Desktop との連携

設定

オプション 1: 自動設定（推奨） 設定スクリプトを実行し、設定を案内します。

./setup_claude_desktop.sh

これにより、以下のことが行われます。

• Anybox API 接続をテストします。
• Claude Desktop を自動的に設定します。
• すべてが正常に動作していることを確認します。

オプション 2: 手動設定

1. Claude Desktop の設定ファイルを見つけます
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. MCP サーバーの設定を追加します

{
  "mcpServers": {
    "anybox": {
      "command": "/Users/tommertron/coding/anyboxTidier/venv/bin/python",
      "args": [
        "/Users/tommertron/coding/anyboxTidier/anybox_mcp_server.py"
      ],
      "env": {
        "ANYBOX_API_KEY": "your-api-key-here"
      }
    }
  }
}

重要事項:

• /Users/tommertron/coding/anyboxTidier を、このリポジトリをクローンした実際のパスに置き換えます。
• your-api-key-here を、実際の Anybox API キーに置き換えます。
• venv/bin ディレクトリ内の Python インタープリターの完全パスを使用するようにしてください。

3. Claude Desktop を再起動します

利用可能なツール

設定が完了すると、Claude は以下のツールにアクセスできるようになります。

search_bookmarks

様々なフィルターでブックマークを検索します。 パラメーター:

• query (オプション): 検索キーワード
• tag_id (オプション): タグ ID でフィルター
• folder_id (オプション): フォルダ ID でフィルター
• starred (オプション): "yes" または "no"
• limit (オプション): 最大結果数（デフォルト: 50）

例のプロンプト:

• "Python に関する Anybox のブックマークを検索して"
• "すべてのスター付きブックマークを見つけて"
• "'Work' フォルダ内のブックマークを検索して"

list_tags

ID とブックマーク数を含むすべてのタグを取得します。 例のプロンプト:

• "私のすべての Anybox タグを一覧表示して"
• "私はどのようなタグを持っていますか？"

list_folders

ID とブックマーク数を含むすべてのフォルダを取得します。 例のプロンプト:

• "私のすべての Anybox フォルダを一覧表示して"
• "Anybox にどのようなフォルダがありますか？"

save_bookmark

オプションのメタデータで新しいブックマークを保存します。 パラメーター:

• url (必須): URL またはノート内容
• comment (オプション): ブックマークに関するコメント
• tag_ids (オプション): タグ ID の配列
• folder_id (オプション): フォルダ ID
• starred (オプション): ブール値（デフォルト: false）

例のプロンプト:

• "https://example.com を Anybox に保存して"
• "この URL を 'Programming' タグ付きで Anybox に保存して"
• "https://github.com を Anybox の 'Work' フォルダに追加して"

典型的なワークフローの例

Claude Desktop との典型的な会話は次のとおりです。

あなた: "私のすべての Anybox タグを一覧表示して"
Claude: [list_tags ツールを使用]
        "あなたは 15 個のタグを持っています。いくつかの例を挙げると、Programming、Design、Research などです。"

あなた: "Programming タグ付きのブックマークを検索して"
Claude: [list_tags を使用してタグ ID を取得し、search_bookmarks を使用]
        "Programming タグ付きの 23 個のブックマークが見つかりました。
         1. Python Documentation - https://docs.python.org
         2. ..."

あなた: "https://github.com/anthropics/anthropic-sdk-python を Programming タグ付きで Anybox に保存して"
Claude: [list_tags を使用してタグ ID を取得し、save_bookmark を使用]
        "✅ ブックマークが正常に保存されました！"

トラブルシューティング

接続エラー

エラー: Connection refused または Error searching bookmarks 解決策:

1. Anybox が実行されていることを確認します。
2. API が http://127.0.0.1:6391 で実行されていることを確認します。
3. API キーが正しいことを確認します。
4. 接続を手動でテストします。

curl -H "x-api-key: YOUR_KEY" http://127.0.0.1:6391/tags

API キーの問題

エラー: 401 Unauthorized または Incorrect API Key 解決策:

1. Anybox の設定から新しい API キーをコピーします。
2. 環境変数が正しく設定されていることを確認します。
3. 設定を更新した後、Claude Desktop を再起動します。

Python/MCP の問題

エラー: mcp module not found 解決策:

pip install mcp httpx

エラー: Python バージョンが互換性がない 解決策: Python 3.10 以上がインストールされていることを確認します。

python3 --version

🔧 技術詳細

API リファレンス

このサーバーは、http://127.0.0.1:6391 で実行されている Anybox のローカル HTTP API を使用しています。

検出されたエンドポイント

• GET /search?q=&tag=&folder=&starred=&limit= - ブックマークを検索します。
• GET /tags - すべてのタグを一覧表示します。
• GET /folders - すべてのフォルダを一覧表示します。
• POST /save - {note, comment, tags[], folder, starred} でブックマークを保存します。

認証

すべてのリクエストは、API キーを含む x-api-key ヘッダーを使用します。

開発

サーバーを直接実行する

テスト用に、次のコマンドを実行します。

python3 anybox_mcp_server.py

サーバーは、MCP プロトコルを使用して標準入出力を介して通信します。

新しいツールの追加

新しい機能を追加するには、以下の手順を実行します。

1. list_tools() でツール定義を追加します。
2. call_tool() でハンドラーを実装します。
3. AnyboxAPI クラスに新しい API メソッドを追加します。

クレジット

• Anybox 用に Anybox Ltd によって構築されました。
• Model Context Protocol を使用しています。
• Raycast Anybox Extension からインスピレーションを得ています。

📄 ライセンス

MIT ライセンス - Anybox API ドキュメントのソースについては、claude.md を参照してください。

コントリビューション

コントリビューションは歓迎されます！追加の Anybox API エンドポイントや機能を発見した場合は、PR を送信してください。

注意: これは非公式の統合です。Anybox は公式の公開 API ドキュメントを提供していません。このサーバーは、Raycast 拡張機能やその他のコミュニティソースからの逆エンジニアリングに基づいています。