🚀 📄 MCP笔记项目文档

本项目旨在为用户打造一个基于模型上下文协议的笔记管理工具，具备列出、获取、创建和删除笔记等功能，为笔记管理提供便捷高效的解决方案。

🚀 快速开始

本项目可通过以下步骤快速启动：

1. 安装项目依赖。
2. 配置运行所需的凭据。
3. 运行Web服务器。

✨ 主要特性

• 支持多种AI模型集成，可灵活适配不同的AI应用场景。
• 提供Web界面进行笔记管理，操作直观便捷。
• 拥有灵活的标签系统，方便对笔记进行分类和检索。
• 实现数据持久化存储，确保笔记数据的安全性和可靠性。

📦 安装指南

使用以下命令安装项目：

npm install -p mcp-notes

💻 使用示例

运行实例

使用以下命令启动服务：

npx mcp-notes mcp-notes-server --dynamodb "dynamodb://localhost:8000"

运行Web服务器

使用以下命令构建并启动Web服务器：

npm run build && node dist/notes-mcp-server.js

📚 详细文档

🔑 凭据配置

连接字符串示例

const dynamodbUri = new URL('http://localhost:8000');

环境变量配置

export DYNAMODB_URI=http://localhost:8000

🛠️ 工具集成

• Claude Desktop：完全支持工具调用和资源显示。
• Cody：仅支持提及笔记，不支持工具调用。
• Cline：完全支持工具调用，资源功能待验证。

🔧 可用工具命令

listNotes

• 输入：{ tags?: string[] }
• 输出：按标签过滤的笔记列表。

getNote

• 输入：{ id: string }
• 输出：指定ID的笔记详情或未找到消息。

writeNote

• 输入：{ id: string, title: string, summary: string, tags: string[], content: string }
• 输出：新建笔记成功确认信息。

deleteNote

• 输入：{ id: string }
• 输出：删除操作完成提示。

📝 数据结构定义

📸 屏幕快照

Claude Desktop

• 工具调用功能截图：
• 资源显示截图：

Cody

• 笔记提及功能截图：

Cline

• 工具调用功能截图：（此处原文档未给出具体图片描述内容，可根据实际情况补充）