A
securityA
licenseA
qualityAn MCP server for managing and persisting notes, offering CRUD operations, note summarization, and resource-based access via a note:// URI scheme.
Last updated -
4
7
MIT License
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 エンコードを設定します
This server cannot be installed
Related Resources
Related MCP Servers
- -securityFlicense-qualityA TypeScript-based MCP server that enables users to manage text notes with features like note creation and summary generation using a Model Context Protocol.Last updated -1
- -securityAlicense-qualityA Model Context Protocol server that synchronizes Markdown files with Notion pages without using LLM tokens, enabling direct interaction with Notion databases and pages through API calls.Last updated -50MIT License
- AsecurityFlicenseAqualityA local development server that provides an interface for managing and accessing markdown documents using the Model Context Protocol (MCP).Last updated -2