Skip to main content
Glama
enesjakozh

Notes MCP Server

by nathannj
GitHub
Python
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 : ノートの総数

設定

  1. 必要な依存関係をインストールします。
pip install -r requirements.txt
  1. main.py の 110 行目の notes_dir プロパティを編集して、指定されたディレクトリ内でサーバーが動作するように構成します。
  2. 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

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

指定されたディレクトリ内のマークダウン ノートを管理し、ユーザーがモデル コンテキスト プロトコルを通じてノートを作成、読み取り、更新、および一覧表示できるようにします。

  1. 特徴
    1. サーバー機能
      1. リソース
        1. ツール
          1. ノートを作成
          2. メモを読む
          3. 更新ノート
          4. リストノート
        2. 設定
          1. サーバーの実行
            1. エラー処理
              1. 構成の詳細

                Related MCP Servers

                • @kazuph/mcp-obsidian

                  kazuph
                  A
                  security
                  A
                  license
                  A
                  quality
                  Obsidian vault connector for Claude Desktop - enables reading and writing Markdown notes using Model Context Protocol (MCP)
                  Last updated -
                  4
                  36
                  3
                  JavaScript
                  MIT License
                  • Apple

                • MCP Notes Server

                  truaxki
                  A
                  security
                  A
                  license
                  A
                  quality
                  An MCP server for managing and persisting notes, offering CRUD operations, note summarization, and resource-based access via a note:// URI scheme.
                  Last updated -
                  4
                  6
                  Python
                  MIT License

                • browser-use MCP server

                  adamdude828
                  A
                  security
                  F
                  license
                  A
                  quality
                  This server provides a note storage system with a custom URI scheme, allowing users to add and summarize notes, with adjustable summary detail levels.
                  Last updated -
                  1
                  Python
                  • Apple

                • MCP Documentation Service

                  alekspetrov
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol implementation that enables AI assistants to interact with markdown documentation files, providing capabilities for document management, metadata handling, search, and documentation health analysis.
                  Last updated -
                  14
                  346
                  11
                  TypeScript
                  MIT License
                  • Apple
                  • Linux

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/nathannj/mcp-notes'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server