mcpField
N
notes-mcp-server

notes-mcp-server

本地服务
github.com/coilybits记忆与知识079 周前更新
代码仓库

关于 notes-mcp-server

notes-mcp-server 是一个为 AI 助手提供结构化笔记操作的 MCP 服务，使用 Apache Ignite 持久化笔记。它提供笔记读写、工具和提示词访问。

主要功能

  1. 01列出数据库中的笔记
  2. 02读取笔记
  3. 03创建和删除笔记
  4. 04列出并查看提示词

适用场景

  1. 01查询已保存的笔记
  2. 02创建或删除笔记
  3. 03通过提示词辅助笔记操作

MCP 相关

该 MCP 服务向 AI 客户端提供笔记资源的列举与读取、创建和删除工具，以及提示词访问。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "notes": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

notes-mcp-server

一个 Model Context Protocol（MCP）服务，为 AI 助手提供安全且结构化的方式来创建、读取、更新和删除简单笔记。笔记使用 apach ignite 持久化。

功能

  • list_resources 列出数据库中的所有笔记
  • read_resource 从数据库读取笔记
  • list_tools 列出 AI 助手可访问的工具
  • call_tool 执行工具（创建笔记、删除笔记）
  • list_prompts 列出实用的提示词
  • get_prompt 查看提示词

配置

  • --host 数据库主机
  • --port 数据库端口

用法

Continue.dev

{
  "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"
      ]
    }
  }
}

许可证

MIT 许可证——详见 LICENSE。

先决条件

  • Python 和 uv 包管理器
  • MCP 服务依赖项
  • Apache Ignite

开发

# Clone the repository
git clone https://github.com/coilybits/notes-mcp-server.git
cd notes-mcp-server

# Create virtual environment
uv venv
source venv/bin/activate 

# Install development dependencies
uv sync

用于调试的 MCP Inspector：

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。