Apple Notes MCP Server

📝 Apple Notes MCP サーバー

**Apple Notes MCPサーバーは、**自然言語によるApple Notesとのシームレスなインタラクションを可能にするモデルコンテキストプロトコルサーバーです。Claudeやその他のAIアシスタントを使って、ノートの作成、検索、取得を簡単に行うことができます！🎉

🎯 機能

• **ノートを作成:**タイトル、コンテンツ、タグを付けて新しいノートをすばやく作成します 📝
• **ノートの検索:**強力な検索機能を使ってノートを検索します 🔍
• **コンテンツの取得:**タイトルからノートの全コンテンツを取得できます 📖
• iCloud 統合: iCloud Notes アカウントと直接連携します ☁️

🚀 はじめに

前提条件

1. Apple Notesアプリが設定されたmacOS
2. Node.js (バージョン 20.0.0 以上)
3. Yarn パッケージマネージャー

インストール

1. リポジトリをクローンします。
   git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git cd mcp-apple-notes
2. 依存関係をインストールします:
   yarn install
3. プロジェクトをビルドします。
   yarn build
4. サーバーを起動します。
   yarn start
5. Claude Desktop を設定します。claude_desktop_config.json claude_desktop_config.json以下のように更新します。
   { "mcpServers": { "apple-notes": { "command": "yarn", "args": ["start"], "cwd": "/path/to/mcp-apple-notes" } } }

   注: /path/to/mcp-apple-notesをクローンしたリポジトリの実際のパスに置き換えてください。コマンドを初めて実行する際に、スクリプトがApple Notesにアクセスできるように承認する必要がある場合があります。

MCP サーバーの初期化

サーバーが正常に起動すると、次のように表示されます。

サーバーはノート操作を処理する準備が整いました！🎉

🛠️ 使用方法

利用可能なツール

1. メモを作成
   • 説明: Apple Notesに新しいメモを作成します
   • パラメータ:
     { title: string; // The title of the note content: string; // The content of the note tags?: string[]; // Optional tags for the note }
   • 応答例:
     Note created: My New Note
2. 検索ノート
   • 説明: タイトルでノートを検索する
   • パラメータ:
     { query: string; // The search query }
   • 応答例:
     Meeting Notes Shopping List Ideas for Project
3. ノートコンテンツを取得する
   • 説明: 特定のメモの全内容を取得します
   • パラメータ:
     { title: string; // The exact title of the note }
   • 応答例:
     [Full content of the note]

📚 使用例

1. 素早くメモを取る

会議やブレーンストーミング セッション中にメモを作成します。

2. 情報検索

必要なときに特定のメモを検索します。

3. コンテンツのレビュー

特定のメモの完全な内容を取得します。

⚡ 最良の結果を得るためのヒント

• Apple NotesアプリがiCloudで正しく設定されていることを確認してください
• 検索性を高めるために説明的なタイトルを使用する
• 整理しやすくするために、メモを作成するときに関連タグを追加します。

🔧 開発

このプロジェクトはTypeScriptを使用し、最新のESモジュールパターンに準拠しています。主なファイル：

• src/index.ts : メインサーバーの実装
• src/services/appleNotesManager.ts : コアノート管理機能
• src/utils/applescript.ts : AppleScript統合ユーティリティ

開発コンテナ

VS Code ユーザー向けに開発コンテナ構成が提供されており、次の機能が提供されます。

• TypeScript Node.js環境
• コードフォーマット用のPrettier
• 依存関係の自動インストール

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

Apple Notesユーザーのために❤️で作成