MCP ノートサーバー

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

特徴

新しいマークダウンノートを作成する
既存のマークダウンノートを読む
既存のマークダウンノートを更新する
金庫内のすべてのメモを一覧表示する
指定されたディレクトリ内の自動ファイル管理
適切なエラー処理とログ記録
メモの作成と変更のタイムスタンプ追跡
すべての操作に対するJSONスキーマ検証

サーバー機能

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

バージョン: 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 : ノートの総数

設定

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

pip install -r requirements.txt

main.py の 110 行目の notes_dir プロパティを編集して、指定されたディレクトリ内でサーバーが動作するように構成します。
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 エンコードを設定します

Notes MCP Server

Integrations

MCP ノートサーバー

特徴

サーバー機能

リソース

ツール

ノートを作成

メモを読む

更新ノート

リストノート

設定

サーバーの実行

エラー処理

構成の詳細