MCP 笔记记录器（概念验证）

这是一个用于AI助手笔记记录的模型上下文协议（MCP）服务器的概念验证实现，包含自定义工具和资源来管理笔记。

概述

本项目展示了如何创建并使用一个提供笔记记录功能的模型上下文协议（MCP）服务器，这些功能可以被AI助手（如Claude、Cursor等支持MCP的助手）使用。该服务器包括：

• 添加笔记的工具
• 获取最新笔记的资源
• 总结所有笔记的提示

所有笔记都存储在项目目录下的本地notes.txt文件中。

需求

• Python 3.11
• 在requirements.txt中列出的所需包

安装与设置

1. 克隆此仓库：

git clone https://github.com/yourusername/mcp-server-poc.git
cd mcp-server-poc

2. 创建并激活虚拟环境：

# 初始化uv包管理器
uv init

# 创建Python 3.11虚拟环境
uv venv

# 在Windows上激活
 .venv\Scripts\activate

# 在macOS/Linux上激活
source venv/bin/activate

3. 安装所需的包：

uv pip install -r requirements.txt

4. （可选）如果需要开发或替代集成，安装MCP CLI工具：

uv add "mcp[cli]"

运行应用程序

要运行MCP服务器：

uv run mcp

服务器将启动并等待通过stdio传输方法连接。

与Cursor集成

要使用此MCP服务器与Cursor IDE集成：

1. 创建或编辑文件~/.cursor/mcp.json（在Windows上为：C:\Users\<username>\.cursor\mcp.json），内容如下：

{
    "mcpServers": {
        "mcp-server": {
            "command": "python",
            "args": [
                "ABSOLUTE/PATH/TO/main.py"
            ]
        }
    }
}

2. 将路径替换为你的main.py文件的绝对路径。

   • 在Windows上，使用双反斜杠：C:\\Users\\username\\path\\to\\main.py
   • 在macOS/Linux上，使用常规斜杠：/Users/username/path/to/main.py

3. 完全重启Cursor（包括结束任何后台进程），以加载MCP服务器。

功能

工具

• add_note(note: str): 向notes.txt文件添加一条笔记，并返回确认消息。

资源

• notes://latest: 返回notes.txt文件中的最新笔记，如果没有笔记则返回消息。

提示

• note_summary_prompt(): 生成提示，要求AI总结notes.txt中的所有当前笔记。

技术细节

• 所有笔记都存储在项目根目录下的名为notes.txt的纯文本文件中。如果文件不存在，会自动创建。
• 服务器使用模型上下文协议SDK和mcp[cli]依赖。

Windows二进制模式修复

如果你在Windows上使用stdio传输，可能需要为stdin/stdout设置二进制模式。详情见MCP文档。

故障排除

• 确认已安装所有必需的包（使用pip list检查）
• 检查配置文件中的绝对路径是否正确
• 确保MCP服务器正在使用正确的Python版本（3.11）
• 如果遇到问题，请尝试直接运行MCP服务器查看错误输出

许可证

MIT许可证

致谢

• 本项目使用了模型上下文协议SDK