🚀 笔记 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。