AI助手笔记服务

MCP取钞机（POC）

用于人工智能辅助笔记的模型上下文协议（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. 创建并激活虚拟环境：

# Init uv package manager 
uv init

# Create a Python 3.11 virtual environment
uv venv

# Activate on Windows
 .venv\Scripts\activate

# Activate on 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（注：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许可证

致谢

• 该项目使用 模型上下文协议 软件开发工具包