MCP Notes Server

MCP Notes Server

~/DocumentationGenerator/notes/ に保存されたメモにアクセスできる、シンプルな MCP（Message Coordination Protocol）サーバーです。

セットアップ

1. Python 3.7+ がインストールされていることを確認します
2. 仮想環境を作成します：

   python -m venv venv
   

3. 仮想環境を有効化します：
   • macOS/Linux の場合：source venv/bin/activate
   • Windows の場合：venv\Scripts\activate
4. 依存関係をインストールします：

   pip install -r requirements.txt
   

サーバーの実行

MCP サーバーを起動するには：

python notes.py

これにより、サーバーが http://0.0.0.0:8000 で起動します。

API エンドポイント

サーバーは次の MCP コマンドを公開します：

• list_notes() - すべてのメモを取得します
• get_note(note_name) - 名前を指定して特定のメモを取得します
• search(query, note_name=None) - クエリ文字列でメモを検索します

メモの形式

メモは、指定されたディレクトリに次の形式の JSON ファイルとして保存されます：

{
    "category": "category",
    "summary": "summary of the notes", 
    "tags": [
        {
            "tag": "tag of the sub detail",
            "summary": "high level business logic of the sub details",
            "messages": [
                {
                    "timestamp": "timestamp of the message",
                    "message": "message content"
                },
                {
                    "timestamp": "timestamp of the message",
                    "message": "message content"
                },
                ...
            ]
        }
    ]
}

クライアントの使用例

クライアントから MCP サーバーに接続する方法を示す、シンプルな Python の例です：

from mcp.client import MCPClient

# Connect to the MCP server
client = MCPClient("http://localhost:8000")

# List all notes
notes = client.call("notes.list_notes")

# Get a specific note
note = client.call("notes.get_note", note_name="your-note-name")

# Search for notes
search_results = client.call("notes.search", query="important")