Affinitymcp

🚀 AffinityMCP

Universal MCP Server (Rust) は、Canvaのワークフロー用のツールと、Affinity Photo/Designer/Publisherの自動化を提供します。これらは、MCP互換クライアントでの自然言語使用を念頭に設計されています。

✨ 主な機能

• 🎨 自然言語制御：自然言語コマンドを使用してAffinityアプリケーションを制御できます。
• 🖼️ ファイル操作：ファイルを開いたり、新しいドキュメントを作成したり、さまざまな形式でエクスポートしたりできます。
• ⚡ 16並列処理：最大16個のファイルを同時に処理し、最大限の効率を実現します。
• 🔧 高度なツール：フィルターを適用したり、ドキュメント情報を取得したりするなどの機能があります。
• 🚀 簡単なセットアップ：初心者にも分かりやすい包括的なドキュメント付きで、簡単にセットアップできます。
• 🌐 クロスプラットフォーム対応：現在はmacOS (AppleScript) 対応で、Windowsサポートも計画されています。

🚀 クイックスタート

初心者の方は、SETUP_GUIDE.md を参照して、詳細な手順を確認してください。

クイックインストール：

# ビルド
cargo build --release
cp target/release/affinity-mcp dist/

# Cursorで使用する場合
# Cursor MCP設定に追加：
{
  "mcpServers": {
    "affinity-mcp": {
      "command": "npx",
      "args": ["affinity-mcp"],
      "autoStart": true
    }
  }
}

📦 インストール

前提条件

• Node.js 18+ (thin npx wrapper用)
• Rust 1.76+ / Cargo (ローカルビルド用)
• Canva Connect/MCPエンドポイントを使用する場合は、AFFINITY_MCP_API_KEY を設定してください。

APIキーの取得

• ツールがCanva APIを必要とする場合は、Canva開発者コンソールまたはMCPサーバーのガイダンスから認証情報を取得してください。そうでない場合は、この手順をスキップできます。

ローカルビルド

cd /path/to/affinity-mcp
cargo build --release
# target/release/affinity-mcp -> ./dist/ にコピー
cp target/release/affinity-mcp dist/

セットアップ: Claude Code (CLI)

このワンライナーを使用してください（実際の値に置き換えてください）：

claude mcp add AffinityMCP -s user -e AFFINITY_MCP_API_KEY="sk-your-real-key" -- npx affinity-mcp

削除するには：

claude mcp remove AffinityMCP

セットアップ: Cursor (.cursor/mcp.jsonはコミットしないでください)

クライアントで設定を作成します：

{
  "mcpServers": {
    "affinity-mcp": {
      "command": "npx",
      "args": ["affinity-mcp"],
      "env": { "AFFINITY_MCP_API_KEY": "sk-your-real-key" },
      "autoStart": true
    }
  }
}

その他のクライアントとエージェント

セットアップ: Codex (TOML)

例 (Serena):

[mcp_servers.serena]
command = "uvx"
args = ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "codex"]

このサーバー (最小構成):

[mcp_servers.affinity-mcp]
command = "npx"
args = ["affinity-mcp"]

# オプションの環境変数:
# AFFINITY_MCP_API_KEY = "sk-your-real-key"
# MCP_NAME = "affinity-mcp"

設定 (環境変数)

• AFFINITY_MCP_API_KEY: Canva APIキーまたはトークン (適用可能な場合)
• MCP_NAME: サーバー名の上書き (デフォルト: affinity-mcp)

ツールが純粋にローカルで使用される場合は、APIキーは必要ありません。

💻 使用例

自然言語コマンド

Cursorまたはその他のMCP互換クライアントでは、自然言語を使用できます。

例1: ファイルを開く

ユーザー: "Open /Users/john/Desktop/image.jpg in Affinity Photo"
AI: [Calls affinity.open_file with path="/Users/john/Desktop/image.jpg", app="Photo"]

例2: 作成とエクスポート

ユーザー: "Create a new Affinity Photo document with size 1920x1080, then export it as PDF to my Desktop"
AI: [Calls affinity.create_new, then affinity.export]

例3: ドキュメント情報を取得

ユーザー: "What document is currently open?"
AI: [Calls affinity.get_active_document]

例4: バッチ操作 (16並列)

ユーザー: "Open these 5 images simultaneously: /path/to/img1.jpg, /path/to/img2.jpg, /path/to/img3.jpg, /path/to/img4.jpg, /path/to/img5.jpg"
AI: [Calls affinity.batch_open_files with paths array]

例5: バッチエクスポート (16並列)

ユーザー: "Export all open documents as PDF files to the Desktop"
AI: [Calls affinity.batch_export with multiple export configurations]

直接ツール呼び出し (MCPツール呼び出し)

{
  "type": "tool",
  "name": "affinity.open_file",
  "arguments": {
    "path": "/path/to/image.jpg",
    "app": "Photo"
  }
}

📚 ドキュメント

• SETUP_GUIDE.md: 初心者にも分かりやすい、詳細なセットアップガイド
• SPEC.md: 技術仕様書 (日本語)
• README.md: このファイル (英語ドキュメント)

複雑なスキーマについては、src/tools/*.rs を参照してください。

名前の一貫性とトラブルシューティング

識別子やキーには常にCANONICAL_ID (affinity-mcp) を使用してください。 UIラベルにのみCANONICAL_DISPLAY (AffinityMCP) を使用してください。 登録後は、レガシーキーを混在させないでください。

一貫性マトリックス

• npmパッケージ名 → affinity-mcp
• バイナリ名 → affinity-mcp
• MCPサーバー名 → affinity-mcp
• 環境変数のデフォルトMCP_NAME → affinity-mcp
• クライアントレジストリキー → affinity-mcp
• UIラベル → AffinityMCP

競合のクリーンアップ

古いキーを削除し、affinity-mcp でのみ再追加してください。 CursorはUIでのみ設定されるため、このリポジトリでは .cursor/mcp.json を意図的に省略しています。