Noteplan MCP

🚀 NotePlan MCP Server

Message Control Protocol (MCP)サーバーで、Claude DesktopとNotePlan.coを連携させます。このサーバーにより、ClaudeとNotePlanのノートがシームレスに統合され、Claudeの会話から直接ノートを照会、検索、作成、更新することができます。

✨ 主な機能

• ノートの読み取り：すべてのノート、IDで特定のノート、または特定のフォルダからのノートを取得します。
• 検索：すべてのノートを対象に全文検索を行います。
• ノートの作成：タイトル、内容、フォルダ構成を指定して新しいノートを作成します。
• 日次ノート：自動的な日付フォーマットで日次ノートを作成および管理します。
• ノートの更新：既存のノートのタイトルと内容を変更します。
• フォルダ構成：フォルダでノートを整理およびフィルタリングします。

📦 インストール

オプション1: GitHubからクローンする

git clone https://github.com/bscott/noteplan-mcp.git
cd noteplan-mcp
npm install

オプション2: NPMパッケージとしてインストールする（近日公開予定）

npm install -g noteplan-mcp

🚀 クイックスタート

1. 依存関係のインストール：

   npm install
   

2. プロジェクトのビルド：

   npm run build
   

3. サーバーのテスト：

   npm start
   

   「NotePlan MCP server running on stdio」と表示されれば正常です。
4. Claude Desktopの設定（以下の詳細セットアップを参照）

📚 ドキュメント：Claude Desktopの設定

このMCPサーバーをClaude Desktopとともに使用するには、Claude Desktopの設定ファイルに以下の設定を追加します。

ステップ1: 設定ファイルの場所を特定する

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

ステップ2: NotePlan MCPサーバーを追加する

claude_desktop_config.jsonに以下の設定を追加します。

{
  "mcpServers": {
    "noteplan": {
      "command": "node",
      "args": ["/absolute/path/to/noteplan-mcp/build/index.js"],
      "cwd": "/absolute/path/to/noteplan-mcp"
    }
  }
}

重要：/absolute/path/to/noteplan-mcpをこのリポジトリをクローンした実際のパスに置き換えてください。

ステップ3: Claude Desktopを再起動する

設定を保存した後、変更を反映するためにClaude Desktopを完全に再起動します。

💻 使用例：利用可能なツール

設定が完了すると、Claudeの会話で以下のツールを使用できます。

💻 使用例：Claudeでの使用例

設定が完了すると、Claudeに以下のようなことを依頼できます。

• 「すべてのノートを表示して」
• 「「プロジェクト計画」を含むノートを検索して」
• 「「Work」フォルダに「Meeting Notes」というタイトルの新しいノートを作成して」
• 「今日の日次ノートを取得して」
• 「ノートID「note123」の内容を更新して」

Claudeは自動的に適切なNotePlan MCPツールを使用してこれらのリクエストを処理します。

🔧 技術詳細：開発

開発モード

npm run dev

これにより、TypeScriptがビルドされ、nodemonを使用してファイルの変更時に自動的にサーバーが再起動します。

ビルド

npm run build

TypeScriptをbuild/ディレクトリにJavaScriptにコンパイルします。

テスト

npm test

リント

npm run lint

🔧 技術詳細：プロジェクト構造

noteplan-mcp/
├── src/
│   ├── index.ts               # メインのMCPサーバー実装
│   ├── index.js               # HTTPサーバー（代替）
│   └── services/
│       └── noteService.ts     # ノート管理ロジック
├── build/                     # コンパイルされたJavaScript出力
│   ├── index.js               # コンパイルされたMCPサーバー
│   └── services/
│       └── noteService.js     # コンパイルされたノートサービス
├── tests/
│   └── index.test.js          # テストファイル
├── tsconfig.json              # TypeScript設定
├── package.json
└── README.md

🔧 技術詳細：トラブルシューティング

Claude Desktopが接続できない場合

1. ファイルパスを確認する：claude_desktop_config.json内のパスが絶対パスで正しいことを確認してください。
2. Node.jsを確認する：Node.jsがインストールされており、PATHからアクセス可能であることを確認してください。
3. ログを確認する：Claude Desktopのログにエラーメッセージがないか確認してください。
   • macOS：~/Library/Logs/Claude/mcp-server-noteplan.log
   • Windows：%LOCALAPPDATA%\Claude\Logs\mcp-server-noteplan.log

一般的なエラーメッセージ

• "Cannot find module '/src/mcp-server.js'"：設定内のパスが間違っています。相対パスではなく絶対パスを使用してください。
• "Server disconnected"：Node.jsがインストールされており、npm startでサーバーが起動できることを確認してください。

設定のテスト

1. 手動でサーバーをテストする：

   cd /path/to/noteplan-mcp
   npm run build
   npm start
   

2. MCPインスペクターを使用してデバッグする：

   npm run inspector
   

3. Claude Desktopのログで接続状態を確認する
4. Claudeで簡単なコマンド「ノートを表示して」を試す

🔧 技術詳細：設定

カスタムNotePlanディレクトリ

デフォルトでは、サーバーは標準の場所でNotePlanファイルを探します。カスタムディレクトリを使用する場合は、noteService.jsファイルを変更して、NotePlanデータディレクトリを指すようにします。

環境変数

現在は環境変数は必要ありませんが、将来的なバージョンでは以下がサポートされる可能性があります。

• NOTEPLAN_DATA_DIR：カスタムNotePlanデータディレクトリ
• MCP_LOG_LEVEL：ログの詳細度

🔧 技術詳細：コントリビュート

1. リポジトリをフォークする
2. 機能ブランチを作成する：git checkout -b my-new-feature
3. 変更を加え、テストを追加する
4. テストスイートを実行する：npm test
5. リンターを実行する：npm run lint
6. 変更をコミットする：git commit -am 'Add some feature'
7. ブランチにプッシュする：git push origin my-new-feature
8. プルリクエストを送信する

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

📚 ドキュメント：サポート

• バグや機能要求についてはGitHubでイシューを開いてください。
• 一般的なMCPの質問については、MCP Documentationを確認してください。
• セットアップに関する問題については、Claude Desktopのドキュメントを確認してください。