Notes MCP Server

🚀 筆記 MCP 服務器

筆記 MCP 服務器是一個模型上下文協議 (MCP) 服務器，它能讓 AI 助手與數據庫進行交互。該服務器以安全且結構化的方式實現筆記的 CRUD 操作，使用 apach ignite 進行數據持久化。

🚀 快速開始

使用此筆記 MCP 服務器前，需要滿足以下先決條件：

• Python 並安裝 uv 包管理器
• MCP 服務器的依賴項
• Apache Ignite

✨ 主要特性

• list_resources：列出數據庫中的所有筆記
• read_resource：從數據庫讀取一條筆記
• list_tools：列出 AI 助手可以訪問的工具
• call_tool：執行一個工具（創建或刪除筆記）
• list_prompts：提供一些建議提示列表
• get_prompt：查看具體的提示內容

📦 安裝指南

開發環境搭建

# 克隆倉庫
git clone https://github.com/coilybits/notes-mcp-server.git
cd notes-mcp-server

# 創建虛擬環境
uv venv
source venv/bin/activate 

# 安裝開發依賴
uv sync

💻 使用示例

Continue.dev

在 Continue.dev 中配置 MCP 服務器：

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "/path/to/uv",
          "args": [
            "--directory",
            "/path/to/notes-mcp-server",
            "run",
            "main.py"
          ]
        }
      }
    ]
  }
}

Claude Desktop

在 Claude 的配置文件中添加 MCP 服務器：

{
  "mcpServers": {
    "messaging": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/notes-mcp-server",
        "run",
        "main.py", "--host=127.0.0.1", "--port=10800"
      ]
    }
  }
}

調試

MCP Inspector 可用於調試：

npx @modelcontextprotocol/inspector uv \
--directory \
/path/to/notes-mcp-server \
run \
main.py

📚 詳細文檔

配置說明

• --host：數據庫所在的主機地址
• --port：數據庫連接的端口號

📄 許可證

本項目採用 MIT License，詳見 LICENSE。