hybrid server

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

Integrations

The README shows a command for running the web server using Bun as an alternative runtime: 'bun src/notes-web-server.ts --dynamodb ...'
The README mentions Node.js multiple times as the primary runtime for the MCP server, with instructions for configuration in various clients.
The README shows integration with npm through the use of npx commands to run the MCP Notes server and web server.

📝 MCP 注释

✨ 概述

MCP Notes Server是一款基于 MCP 协议构建的简易笔记应用。其目标是帮助用户记录和查看复杂的笔记和任务，同时利用 AI 模型，例如记录个人想法、笔记、灵感和见解。它无需创建项目文件，用户可以记录任何内容，而无需在项目内部公开。

该项目包括两个服务器：一个使用模型上下文协议 (MCP) 进行 AI 驱动的笔记管理的 Node.js 服务器，以及一个提供用户友好界面以便与笔记进行手动交互的 Web 服务器。

**注意：**本项目需要使用 DynamoDB 来存储笔记。您需要一个 AWS 账户才能使用它。AWS 为 DynamoDB 提供了慷慨的免费套餐，非常适合个人频繁使用且无需支付任何费用。

🎯 核心功能

🖥️**双服务器架构：**用于 AI 驱动的笔记管理的 MCP 服务器和用于用户界面的 Web 服务器
🤖**人工智能笔记：**通过人工智能互动记录想法、见解和任务
🗂️**全面的笔记管理：**通过 AI 或 Web 界面创建、列出、检索、更新和删除笔记
📋**可靠的存储：**使用 AWS DynamoDB 进行安全高效的笔记存储
🔐**灵活的身份验证：**通过连接字符串或环境变量支持 AWS 凭证
📝**独立于项目：**存储个人笔记而不影响项目文件或结构

🤖 模型支持

只要您的客户端支持 MCP，您就可以使用任何支持函数调用的模型。以下模型已测试并确认可以正常工作：

克劳德3.5系列
双子座 1.5 和 2.0 系列
GPT-4 系列
米斯特拉尔大号
Grok-2
DeepSeek 聊天

🛠️ 安装

受到推崇的

直接使用npx或bunx运行，请参阅下面的示例。

选择

确保您的系统上安装了Node.js。
克隆此存储库并使用以下命令安装依赖项： npm install
配置 Claude Desktop 或任何其他工具，如下所示

⚙️ 凭证配置

连接字符串

dynamodb://<access_key>:<secret_key>@<region>/<table>

例如： dynamodb://AKIAXXXXXXXX:SKXXXXXXXX@us-east-1/mcp-notes

环境变量

导出AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY 。
在 URI 中提供不带凭证的连接信息： dynamodb://us-east-1/mcp-notes

🤖 与工具集成

克劳德桌面

将此代码片段添加到claude_desktop_config.json ：

{
  "mcpServers": {
    "mcp-notes": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

或本地磁盘上的文件：

{
  "mcpServers": {
    "mcp-notes": {
      "command": "node",
      "args": [
        "file://path/to/notes-mcp-server.js",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

科迪

**注意：**目前，Cody 对 MCP 服务器的支持有限。
它仅允许连接一个服务器，并且无法进行工具调用。您需要使用 Web 界面创建和管理笔记，然后在 AI 聊天对话中引用它们。

将此代码片段添加到您的 VS Code 设置中：

{
  "openctx.providers": {
    "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": {
      "nodeCommand": "node",
      "mcp.provider.uri": "file://path/to/notes-mcp-server.js",
      "mcp.provider.args": [
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

或者，与npx一起使用（不保证有效）：

{
  "openctx.providers": {
    "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": {
      "nodeCommand": "node",
      "mcp.provider.uri": "file:///usr/local/bin/npx",
      "mcp.provider.args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

克莱恩

将此代码片段添加到cline_mcp_settings.json ：

你会发现“新建任务”按钮旁边有一个“MCP 服务器”图标，然后有一个“编辑 MCP 设置”按钮来打开这个文件。

{
  "mcpServers": {
    "mcp-notes": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://access_key:secret_key@region/table"
      ]
    }
  }
}

🚀 运行 Web 服务器

Web 服务器提供了一个用户友好的界面来管理您的笔记。您可以启动 Web 界面来管理您的笔记，为 AI 添加新笔记，或修改 AI 生成的笔记的部分内容。

npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://access_key:secret_key@region/table"

bun src/notes-web-server.ts --dynamodb "dynamodb://access_key:secret_key@region/table"

或者，使用npm run build进行编译并运行node dist/notes-mcp-server.js或node dist/notes-web-server.js

然后在浏览器中导航至http://localhost:3100查看笔记。

🔧 可用的 MCP 工具

列表注释

输入： { tags?: string[] }
**输出：**所有注释的数组，可选择按标签进行过滤。

获取注释

输入： { id: string }
**输出：**与给定 ID 匹配的单个注释对象，如果不存在匹配，则显示“未找到”消息。

写笔记

输入： { id: string, title: string, summary: string, tags: string[], content: string }
**输出：**成功确认消息。

删除注释

输入： { id: string }
**输出：**删除确认消息🚮。

📝 数据结构

注释使用以下结构存储：

id ：笔记的唯一标识符。它应该具有描述性，并带有随机数字后缀，例如“meeting-notes-1362”。
title ：笔记的标题。
summary ：笔记内容的简短摘要。
tags ：与笔记相关的标签数组（例如，[“meeting”，“project-x”]）。
content ：笔记的主要内容。

📸 截图

克劳德桌面

✅ 功能齐全

科迪

✅ 通过资源提及注释

❎ 不支持工具调用

克莱恩

✅ 具有工具调用的完整功能

❓ 资源似乎不起作用；需要帮助。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

一个简单的笔记 MCP 服务器，用于使用 AI 模型记录和管理笔记。

Integrations

📝 MCP 注释

✨ 概述

🎯 核心功能

🤖 模型支持

🛠️ 安装

⚙️ 凭证配置

连接字符串

环境变量

🤖 与工具集成

克劳德桌面

科迪

克莱恩

🚀 运行 Web 服务器

🔧 可用的 MCP 工具

列表注释

获取注释

写笔记

删除注释

📝 数据结构

📸 截图

克劳德桌面

科迪

克莱恩

Appeared in Searches