JinDaGe - notes-mcp-server MCP Details

article

README

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

notes-mcp-server