Keynote Mcp

Keynote-MCP

https://github.com/user-attachments/assets/fb293e54-0795-434f-a811-7f850d36619f

⚠️ 開発に関する注意：このプロジェクトは、人によるコードレビューを受けずに Cursor AI を使用して開発されました。教育および実験目的のみで提供されています。本番環境では注意して使用し、デプロイ前に十分なテストを実施してください。

AppleScript による自動化を通じて、AI アシスタントが Keynote プレゼンテーションを操作できるようにする Model Context Protocol（MCP）サーバーです。

中文文档 | English

✨ 特長

• 🎨 プレゼンテーションの包括的な管理 - プレゼンテーションの作成、開く、保存、閉じる
• 📊 多彩なスライド操作 - スライドの追加、削除、複製、移動
• 📝 強力なコンテンツ管理 - テキスト、画像、図形、表、グラフの追加
• 📸 柔軟なエクスポートオプション - スライドのスクリーンショット、PDF や画像へのエクスポート
• 🖼️ Unsplash との連携 - 高品質な画像を自動で検索して追加
• 🔒 安全で信頼性の高い設計 - 包括的なエラー処理と権限管理
• 🧪 十分なテスト - ユニットテストと統合テストの網羅

---

🚀 クイックスタート

前提条件

• macOS 10.14 以降
• Keynote アプリケーション
• Python 3.8 以降

インストール

1. リポジトリをクローンする

   git clone https://github.com/easychen/keynote-mcp.git
   cd keynote-mcp
   

2. 依存関係をインストールする

   pip install -r requirements.txt
   

3. 環境を設定する（Unsplash 機能を使う場合は任意）

   cp env.example .env
   # Edit .env file and add your Unsplash API key
   

4. macOS のアクセス許可を設定する

   • システム環境設定 > セキュリティとプライバシー > プライバシーを開きます
   • アクセシビリティのアクセス許可に Terminal と Python を追加します
   • Keynote のオートメーションのアクセス許可に Python を追加します

MCP クライアントでの使用

Gemini CLI の設定

この設定を MCP クライアントに追加します。

{
  "KeynoteServer": {
    "command": "python",
    "args": ["start_server.py"],
    "env": {
      "UNSPLASH_KEY": "your_unsplash_api_key_here"
    },
    "cwd": "/path/to/keynote-mcp",
    "timeout": 5000
  }
}

Claude Desktop の設定

claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "keynote": {
      "command": "python",
      "args": ["/path/to/keynote-mcp/start_server.py"],
      "env": {
        "UNSPLASH_KEY": "your_unsplash_api_key_here"
      }
    }
  }
}

その他の MCP クライアント

その他の MCP 対応クライアントでは、以下の接続情報を使用します。

• コマンド：python
• 引数：["start_server.py"]
• 作業ディレクトリ：/path/to/keynote-mcp
• 環境変数：{"UNSPLASH_KEY": "your_api_key"}（任意）

📖 利用可能なツール

このサーバーは、Keynote の自動化に役立つ包括的なツールを提供します。

🎨 プレゼンテーションの管理

• プレゼンテーションの作成、開く、保存、閉じる
• テーマの設定とプレゼンテーション情報の取得
• 開いているすべてのプレゼンテーションの一覧表示

📊 スライド操作

• スライドの追加、削除、複製、移動
• スライドレイアウトの設定とスライド情報の取得
• スライド間の移動

📝 コンテンツ管理

• テキストボックス、タイトル、サブタイトルの追加
• ファイルまたは Unsplash からの画像の挿入
• 箇条書きリストと番号付きリストの作成
• コードブロックと引用の追加

📸 エクスポートとスクリーンショット

• 個々のスライドのスクリーンショットを撮影
• プレゼンテーションを PDF にエクスポート
• 連続した画像としてエクスポート

🖼️ Unsplash との連携（任意）

• 高品質な画像を検索
• スライドに画像を自動で追加
• さまざまな向きとスタイルに対応

💡 使用例

MCP クライアントに接続すると、自然言語で Keynote を操作できます。

• 「AI のトレンドに関する新しいプレゼンテーションを作成して」
• 「タイトルが『機械学習の基礎』のスライドを追加して」
• 「2 枚目のスライドにテクノロジーに関する画像を挿入して」
• 「プレゼンテーションを PDF としてエクスポートして」

🔧 Unsplash の設定（任意）

Unsplash の画像機能を使用するには、以下の手順に従います。

1. API キーを取得する：Unsplash Developersにアクセスします
2. 設定する：API キーを.envファイルに追加します。

   UNSPLASH_KEY=your_unsplash_access_key_here
   

📚 ドキュメント

• インストールガイド - 詳細なセットアップ手順
• 技術ドキュメント - API リファレンスとアーキテクチャ
• 例 - 使用例とデモ

🤝 貢献

貢献を歓迎します！始め方の詳細については、CONTRIBUTING.mdをご覧ください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSEファイルをご覧ください。

🏆 謝辞

• Model Context Protocol - AI モデル向けに標準化されたツール呼び出しプロトコル
• Unsplash - 高品質な無料画像
• AppleScript - 強力なmacOS自動化機能

📞 お問い合わせ

• 🐛 問題: GitHub Issues
• 💬 ディスカッション: GitHub Discussions

⭐ サポート

このプロジェクトがお役に立ったら、ぜひ⭐️を付けてください！

---

AI アシスタントがKeynoteプレゼンテーションを簡単に作成・管理できるよう支援します。