MCP Server Notes

🚀 MCP 筆記服務器

MCP 筆記服務器是一個簡單的 MCP（消息協調協議）服務器，它能夠提供對存儲在 ~/DocumentationGenerator/notes/ 中的筆記的訪問，方便用戶管理和檢索筆記。

🚀 快速開始

安裝指南

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。

✨ 主要特性

• 提供簡單的 MCP 協議接口，方便與客戶端進行交互。
• 支持列出所有筆記、獲取特定筆記以及按查詢字符串搜索筆記等功能。

💻 使用示例

基礎用法

以下是連接到 MCP 服務器的簡單 Python 客戶端示例：

from mcp.client import MCPClient

# 連接到MCP服務器
client = MCPClient("http://localhost:8000")

# 列出所有筆記
notes = client.call("notes.list_notes")

# 獲取特定筆記
note = client.call("notes.get_note", note_name="your-note-name")

# 搜索筆記
search_results = client.call("notes.search", query="important")

📚 詳細文檔

API 接口

服務器暴露以下 MCP 命令：

• list_notes() - 獲取所有筆記
• get_note(note_name) - 通過名稱獲取特定筆記
• search(query, note_name=None) - 按查詢字符串搜索筆記

筆記格式

筆記以 JSON 文件形式存儲在指定目錄中，採用以下格式：

{
    "category": "分類",
    "summary": "筆記摘要", 
    "tags": [
        {
            "tag": "子細節的標籤",
            "summary": "子細節的高級別業務邏輯",
            "messages": [
                {
                    "timestamp": "消息的時間戳",
                    "message": "消息內容"
                },
                {
                    "timestamp": "消息的時間戳",
                    "message": "消息內容"
                }
            ]
        }
    ]
}