🚀 SimpleNote使用指南
这是一个关于如何使用SimpleNote的详细指南，涵盖了安装、配置、使用说明、日志查看、故障排除、贡献指南以及文档参考等内容，帮助你轻松上手和使用该工具。
🚀 快速开始
要开始使用SimpleNote，请按照以下步骤操作：
- 下载并安装Python 3.9或更高版本：
python --version - 安装SimpleNote：
pip install simplenote-mcp-server - 启动服务器：
simplenote-mcp-server
📦 安装指南
安装Python
需下载并安装Python 3.9或更高版本，可通过以下命令查看Python版本：
python --version
安装SimpleNote
使用pip命令安装SimpleNote：
pip install simplenote-mcp-server
启动服务器
安装完成后，使用以下命令启动服务器：
simplenote-mcp-server
✨ 主要特性
- 环境变量配置：通过设置环境变量，如
SIMPLENOTE_EMAIL和SIMPLENOTE_PASSWORD，实现用户认证。 - 丰富的命令支持：提供查看服务器状态、重新启动Claude Desktop和服务器、验证工具是否注册等命令。
- 日志管理：支持查看主日志文件和调试日志文件，并可设置日志级别。
- 故障排除机制：针对常见问题，如认证问题、服务器无法启动、Claude Desktop无法找到工具等，提供详细的解决方法。
📚 详细文档
配置
环境变量配置
在启动服务器之前，请设置以下环境变量：
SIMPLENOTE_EMAIL：你的SimpleNote电子邮件地址。SIMPLENOTE_PASSWORD：你的SimpleNote密码。
例如：
export SIMPLENOTE_EMAIL="your@email.com"
export SIMPLENOTE_PASSWORD="your_password"
使用说明
可用命令
以下是可用的命令列表：
- 查看服务器状态：
ps aux | grep simplenote-mcp - 重新启动Claude Desktop和服务器：
./simplenote_mcp/scripts/restart_claude.sh - 验证工具是否注册：
./simplenote_mcp/scripts/verify_tools.sh
日志文件
主要日志
- 主日志文件：
simplenote_mcp/logs/server.log - 调试日志文件：
/tmp/simplenote_mcp_debug.log
设置日志级别
将LOG_LEVEL设置为DEBUG以查看更多详细信息：
export LOG_LEVEL=DEBUG
故障排除
常见问题
认证问题
症状：出现与凭证相关的错误消息。
解决方法：
- 确认
SIMPLENOTE_EMAIL和SIMPLENOTE_PASSWORD是否正确设置。 - 检查电子邮件地址和密码是否有拼写错误。
- 确保密码中没有特殊字符。
服务器无法启动
症状：服务器启动失败，Claude Desktop无法连接。
解决方法：
- 查看日志文件：
cat simplenote_mcp/logs/server.log - 检查Python版本：
python --version - 确认安装是否正确：
which simplenote-mcp-server
Claude Desktop无法找到工具
症状：Claude提示没有访问到SimpleNote工具。
解决方法：
- 重新启动Claude Desktop和服务器。
- 使用以下命令验证工具注册状态：
./simplenote_mcp/scripts/verify_tools.sh
贡献指南
提交代码
请按照以下步骤提交代码：
- 创建一个分支：
git checkout -b feature/your-feature-name - 提交更改：
git add . git commit -m "你的提交信息" - 推送到远程仓库并创建Pull Request。
问题报告
请按照以下格式报告问题：
- 问题描述：简要说明问题。
- 复现步骤：详细列出复现问题的步骤。
- 预期结果：说明期望的行为。
- 实际结果：说明发生的结果。
文档参考
- 《ROADMAP.md》
- 《LICENSE》
- 《CONTRIBUTING.md》