光标通知MCP-聊天记录器
一个模型上下文协议（MCP）服务器，将您的Cursor AI聊天交互记录到Notion，以进行分析、记录和知识管理。
🌟 特性
- ✅ 自动聊天记录：使用单个命令将Cursor AI对话记录到Notion
- ✅ MCP协议：实现官方的模型上下文协议规范
- ✅ 轻松设置：通过环境变量进行简单配置
- ✅ 丰富的上下文：捕获提示、响应、用户、上下文和时间戳
- ✅ 概念整合：将数据存储在结构化的Notion数据库中
- ✅ 隐私第一：自托管，无第三方服务
📋 先决条件
- Python 3.7或更高版本
- 游标IDE（支持MCP）
- 具有API访问权限的通知帐户
requests图书馆(pip install requests)
🚀 快速开始
1.克隆存储库
git clone https://github.com/Creo-DRB1008/prompt-logger-mcp.git
cd cursor-notion-mcp2.安装依赖项
pip install -r requirements.txt3.设置理念
创建概念集成
- 首选 概念整合
- 点击“新建集成”
- 将其命名为“光标聊天记录器”
- 复制 内部集成令牌 （开始于
secret_)
创建概念数据库
- 在Notion中创建新数据库
- 添加这些属性：
- 提示 （标题）-用户的问题 - 响应 （文本）-AI的回应 - 用户 （文本）-用户标识符 - 上下文 （文本）-文件/函数上下文 - 时间戳 （日期）-发生的时间
- 与您的集成共享数据库：
- 点击数据库上的“共享” - 邀请您的集成
- 得到 数据库ID 从URL：
https://notion.so/YOUR_WORKSPACE/DATABASE_ID?v=...
^^^^^^^^^^^^4.配置光标
编辑 ~/.cursor/mcp.json （如果不存在则创建）：
{
"mcpServers": {
"notion-chat-logger": {
"command": "python3",
"args": [
"/ABSOLUTE/PATH/TO/cursor-notion-mcp/mcp_notion_server.py"
],
"env": {
"NOTION_API_KEY": "secret_YOUR_NOTION_INTEGRATION_TOKEN",
"NOTION_DATABASE_ID": "YOUR_DATABASE_ID"
}
}
}
}重要：替换：
/ABSOLUTE/PATH/TO/此存储库的实际路径secret_YOUR_NOTION_INTEGRATION_TOKEN使用您的Notion集成令牌YOUR_DATABASE_ID使用您的Notion数据库ID
5.重新启动游标
完全退出光标（Mac上的⌘Q，Windows/Linux上的Alt+F4）并重新打开它。
6.验证安装
# Run the test script
python3 test_mcp_notion.py您应该看到：
✅ Initialize response
✅ Found 1 tool(s)
✅ Successfully stored to Notion!💡 用法
在光标聊天中
与Cursor AI交谈后，只需说：
Log this conversation to Notion或者使用工具选择器：
- 类型
@在聊天 - 选择
store_chat_log - 填写细节（或让AI来做）
手动工具调用
您还可以显式调用该工具：
@store_chat_log
Prompt: "How do I implement OAuth?"
Response: "Here's how to implement OAuth..."
User: "your.email@example.com"
Context: "auth.py"🧪 测试
快速验证
./verify_cursor_mcp.sh完整测试套件
python3 test_mcp_notion.py手动MCP协议测试
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | python3 mcp_notion_server.py📁 项目结构
cursor-notion-mcp/
├── mcp_notion_server.py # Main MCP server
├── test_mcp_notion.py # Test suite
├── verify_cursor_mcp.sh # Quick verification script
├── requirements.txt # Python dependencies
├── README.md # This file
├── SETUP.md # Detailed setup guide
├── ARCHITECTURE.md # Technical architecture
└── LICENSE # MIT License🔧 配置
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
NOTION_API_KEY | 是 | 您的Notion集成令牌 |
NOTION_DATABASE_ID | 是 | 您的Notion数据库ID |
NOTION_VERSION | 否 | 通知API版本（默认：2022-06-28） |
概念数据库架构
您的Notion数据库必须具有以下属性：
| 属性 | 类型 | 描述 |
|---|---|---|
| 提示 | 标题 | 用户的问题/提示 |
| 响应 | 文本 | 助理的响应 |
| 用户 | 文本 | 用户标识符（电子邮件） |
| 上下文 | 文本 | 文件路径、函数名等。 |
| 时间戳 | 日期 | 交互发生的时间 |
🐛 故障排除
服务器未显示在光标中
- 检查一下
~/.cursor/mcp.json是有效的JSON - 验证到的绝对路径
mcp_notion_server.py是正确的 - 完全重新启动游标（退出并重新打开）
- 检查游标日志：
~/Library/Logs/Cursor/（Mac）或%APPDATA%\Cursor\logs\（Windows）
工具未出现
- 验证服务器是否列在游标设置中→ 特性→ MCP
- 尝试键入完整的工具名称：
@store_chat_log - 查看开发人员工具（帮助→ 切换开发人员工具）以查看错误
通知API错误
- 验证您的
NOTION_API_KEY正确（以开头secret_) - 验证您的
NOTION_DATABASE_ID正确（32个字符，十六进制） - 确保集成可以访问数据库（共享→ 邀请集成）
- 检查数据库中是否存在所有必需的属性
Python错误
# Check Python version
python3 --version # Should be 3.7+
# Install dependencies
pip3 install -r requirements.txt
# Test the server directly
python3 mcp_notion_server.py
# Then type: {"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}🔐 安全
⚠️ 重要安全注意事项：
- 永远不要提交您的Notion API密钥 到版本控制
- 使用环境变量 敏感数据
- 限制集成权限 在Notion中，只显示您需要的数据库
- 查看记录的数据 定期确保不存储敏感信息
- 考虑加密 测井前的敏感区域
推荐：使用 .env 文件
而不是在中硬编码凭据 mcp.json，使用a .env 文件：
# .env
NOTION_API_KEY=secret_YOUR_TOKEN
NOTION_DATABASE_ID=YOUR_DATABASE_ID然后更新 mcp.json:
{
"mcpServers": {
"notion-chat-logger": {
"command": "bash",
"args": [
"-c",
"source .env && python3 /path/to/mcp_notion_server.py"
]
}
}
}📚 文档
🤝 贡献
欢迎投稿！请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'Add some AmazingFeature') - 推到分支(
git push origin feature/AmazingFeature) - 打开拉取请求
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
📞 支持
- 问题:
- 讨论:
🗺️ 路线图
- \[\]支持多个Notion数据库
- \[\]过滤/编辑敏感数据
- \[\]导出为其他格式（CSV、JSON）
- \[\]用于查看日志的Web仪表板
- \[\]自动标记和分类
- \[\]搜索和分析功能
______________________________________________________________________
由以下材料制成❤️ Cursor社区
如果你觉得这有用，请⭐ 将存储库星化！