Skip to main content
Glama

MCP Notes Server

by truaxki

MCP 注释服务器

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

特征

  • 创建、阅读、更新和删除笔记
  • 使用 JSON 进行持久存储
  • 创建和修改的时间戳跟踪
  • 通过提示进行笔记总结
  • 使用 note:// URI 方案的基于资源的访问

安装

通过 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 操作
  • 多条笔记处理
  • 错误案例
  • 资源访问
  • 提示生成

执照

[在此添加您的许可证]

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

用于管理和保存笔记的 MCP 服务器,提供 CRUD 操作、笔记摘要以及通过 note:// URI 方案进行基于资源的访问。

  1. 特征
    1. 安装
      1. 通过 Smithery 安装
      2. 手动安装
    2. 项目结构
      1. 可用工具
        1. 用法
          1. 贮存
            1. 资源访问
              1. 提示生成
                1. 发展
                  1. 测试
                    1. 执照

                      Related MCP Servers

                      • -
                        security
                        F
                        license
                        -
                        quality
                        A simple note-taking MCP server that allows storing and summarizing notes with custom URI schemes and provides functionality to add notes and generate summaries with different detail levels.
                        Last updated -
                        5
                        Python
                        • Apple
                      • -
                        security
                        F
                        license
                        -
                        quality
                        A Claude-compatible MCP server that enables storing and summarizing notes through a simple note storage system with custom URI scheme.
                        Last updated -
                        3
                        Python
                      • -
                        security
                        -
                        license
                        -
                        quality
                        A simple MCP server for creating and managing notes with support for summarization functionality.
                        Last updated -
                        Python
                      • -
                        security
                        F
                        license
                        -
                        quality
                        A simple MCP server implementing a note storage system with one tool to add notes and one prompt to summarize stored notes.
                        Last updated -
                        1
                        Python
                        • Apple

                      View all related MCP servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/truaxki/mcp-notes'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server