MCP ノートサーバー

これは、指定されたディレクトリ内のMarkdownノートを管理するMCP（Model Context Protocol）サーバー実装です。このサーバーは、stdioトランスポートを使用してMarkdownノートを作成、読み取り、更新する機能を提供します。

特徴

• 新しいマークダウンノートを作成する

• 既存のマークダウンノートを読む

• 既存のマークダウンノートを更新する

• 金庫内のすべてのメモを一覧表示する

• 指定されたディレクトリ内の自動ファイル管理

• 適切なエラー処理とログ記録

• メモの作成と変更のタイムスタンプ追跡

• すべての操作に対するJSONスキーマ検証

Related MCP server: pdf-reader-server

サーバー機能

サーバーは次の機能を実装します。

• バージョン: 1.0.0

• 名前: Notes MCP サーバー

• 説明: 指定されたディレクトリ内のマークダウンノートを管理するためのサーバー

• サポートされているトランスポート: stdio

リソース

サーバーは次のリソースを提供します。

• プロパティ:

  • path : ボールトへのパス

  • note_count : 金庫内のノートの総数

ツール

サーバーは次の MCP ツールを実装します。

ノートを作成

新しいマークダウンノートを作成します。

パラメータ:

• title : ノートのタイトル（必須）

• content : メモの内容（オプション、デフォルトは空の文字列）

戻り値:

• filename : 作成されたファイルの名前

• path : 作成されたファイルへのフルパス

• created_at : 作成時の ISO タイムスタンプ

メモを読む

既存のマークダウン ノートを読み取ります。

パラメータ:

• title : 読むノートのタイトル（必須）

戻り値:

• title : ノートのタイトル

• content : メモの内容

• path : ファイルへのフルパス

• created_at : 作成時の ISO タイムスタンプ

• modified_at : 最終変更の ISO タイムスタンプ

更新ノート

既存のマークダウン ノートを更新します。

パラメータ:

• title : 更新するノートのタイトル（必須）

• content : ノートの新しいコンテンツ（オプション、デフォルトは空の文字列）

戻り値:

• filename : 更新されたファイルの名前

• path : ファイルへのフルパス

• updated_at : 更新のISOタイムスタンプ

リストノート

ボールト内のすべてのマークダウン ノートを一覧表示します。

パラメータ: なし

戻り値:

• notes : ノートオブジェクトの配列。各オブジェクトには次のものが含まれます。

  • title : ノートのタイトル

  • path : ファイルへのフルパス

  • created_at : 作成時の ISO タイムスタンプ

  • modified_at : 最終変更の ISO タイムスタンプ

• total : ノートの総数

設定

1. 必要な依存関係をインストールします。

pip install -r requirements.txt

2. main.py の 110 行目の notes_dir プロパティを編集して、指定されたディレクトリ内でサーバーが動作するように構成します。

3. MCP サーバーを使用するように Cursor を構成します。

   • 設定ファイルは.cursor/mcp.jsonにあります。

   • カーソルは自動的にこの設定を検出して使用します

   • サーバーはPythonと適切なUTF-8エンコーディングで動作するように設定されています

サーバーの実行

Cursorがプロジェクトをロードすると、サーバーは自動的に起動します。手動で実行することもできます。

python main.py

サーバーが起動し、stdin/stdout を介して MCP リクエストをリッスンします。すべての操作は、デバッグと監視のために適切なレベル（情報/エラー）でログに記録されます。

エラー処理

サーバーは、さまざまなシナリオに対して適切なエラー処理を実装します。

• 必要なパラメータが不足しています

• ファイルは既に存在します

• ファイルが見つかりません

• 一般的な例外

すべてのエラーはログに記録され、適切なエラー コードとメッセージとともに返されます。

構成の詳細

MCP サーバーは、次の設定で.cursor/mcp.jsonで構成されます。

{
  "mcpServers": {
    "notes-server": {
      "command": "python",
      "args": ["main.py"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

MCP をグローバルに使用するには、ユーザー ディレクトリの .cursor フォルダに追加するか、カーソル設定 -> MCP -> 新しいグローバル MCP サーバーの追加 -> このプロジェクトの mcp.json を新しいファイルにコピー/貼り付け -> 引数を更新して main.py を指すようにします。

この構成:

• サーバー名を「notes-server」にする

• Pythonを使用してサーバーを実行します

• 適切な文字処理のために UTF-8 エンコードを設定します