Skip to main content
Glama
MCP Notes Server

MCP Notes Server

by truaxki

MCP 注释服务器

铁匠徽章

用于管理具有持久存储的笔记的模型上下文协议 (MCP) 服务器实现。

特征

  • 创建、阅读、更新和删除笔记

  • 使用 JSON 进行持久存储

  • 创建和修改的时间戳跟踪

  • 通过提示进行笔记总结

  • 使用 note:// URI 方案的基于资源的访问

Related MCP server: Beeper MCP Note Server

安装

通过 Smithery 安装

要通过Smithery自动安装 Claude Desktop 的笔记:

npx -y @smithery/cli install notes --client claude

手动安装

  1. 确保安装了 Python 3.10 或更高版本

  2. 创建虚拟环境:

    python -m venv .venv
    
    # On Unix/MacOS:
    source .venv/bin/activate
    
    # On Windows:
    .venv\Scripts\activate
  3. 安装要求:

    pip install MCP

项目结构

notes/
├── __init__.py          # Package initialization
├── server.py           # Main server implementation
├── storage.py          # Note persistence layer
├── resources.py        # Resource handling (note:// URIs)
├── prompts.py         # LLM prompt generation
└── tools/             # Server tools
    ├── __init__.py    # Tools package initialization
    ├── list_tools.py  # Tool listing functionality
    └── handle_tools.py # Tool handling implementation

可用工具

  • add-note :创建新注释

  • list-all-notes :显示所有存储的笔记

  • update-note :修改现有注释

  • delete-note :删除注释

用法

  1. 启动服务器:

    mcp install src/notes
    mcp start Notes
  2. 示例操作:

    # Create a note
    await client.call_tool("add-note", {
        "name": "example",
        "content": "This is a test note"
    })
    
    # List all notes
    await client.call_tool("list-all-notes")
    
    # Update a note
    await client.call_tool("update-note", {
        "name": "example",
        "content": "Updated content"
    })
    
    # Delete a note
    await client.call_tool("delete-note", {
        "name": "example"
    })

贮存

笔记存储在notes_storage.json中,结构如下:

{
    "note_name": {
        "content": "Note content",
        "created_at": "2025-01-12T11:28:16.721704",
        "modified_at": "2025-01-12T11:28:16.721704"
    }
}

资源访问

可以使用note:// URI 方案将注释作为资源进行访问:

  • 列出资源:返回所有可用的注释作为资源

  • 读取资源:使用note://internal/note_name访问特定笔记

提示生成

服务器包含一个用于笔记摘要的提示生成功能:

  • 支持简短和详细的摘要

  • 为语言模型输入格式化注释

  • 可通过“summarize-notes”提示获取

发展

要修改或扩展服务器:

  1. 克隆存储库

  2. 安装开发依赖项

  3. 在适当的模块中进行更改

  4. 部署前彻底测试

测试

测试应涵盖:

  • 基本 CRUD 操作

  • 多条笔记处理

  • 错误案例

  • 资源访问

  • 提示生成

执照

[在此添加您的许可证]

Available Tools

4 tools
add-noteC

Create a new note

Inputs: content (required), name (required).

delete-noteC

Delete an existing note

Inputs: name (required).

list-all-notesB

Read all stored notes

Inputs: no named parameters.

update-noteC

Update an existing note

Inputs: content (required), name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific CRUD operations on notes: add-note for creation, delete-note for deletion, list-all-notes for reading all, and update-note for updates. There is no overlap in functionality, making tool selection unambiguous.

    Naming Consistency4/5

    The tools follow a mostly consistent verb-noun pattern (add-note, delete-note, update-note), but list-all-notes deviates slightly by including 'all'. This minor inconsistency does not significantly hinder readability or predictability.

    Tool Count5/5

    With 4 tools, the server is well-scoped for a notes management system, covering the essential CRUD operations. Each tool earns its place without being overly sparse or bloated, fitting the typical 3-15 tool range appropriately.

    Completeness5/5

    The tool set provides complete CRUD coverage for the notes domain: create (add-note), read (list-all-notes), update (update-note), and delete (delete-note). There are no obvious gaps, allowing agents to handle full note lifecycles without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers