simplenote-mcp-server

🚀 SimpleNote使用指南

这是一个关于如何使用SimpleNote的详细指南，涵盖了安装、配置、使用说明、日志查看、故障排除、贡献指南以及文档参考等内容，帮助你轻松上手和使用该工具。

🚀 快速开始

要开始使用SimpleNote，请按照以下步骤操作：

1. 下载并安装Python 3.9或更高版本：

   python --version
   

2. 安装SimpleNote：

   pip install simplenote-mcp-server
   

3. 启动服务器：

   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"

使用说明

可用命令

以下是可用的命令列表：

1. 查看服务器状态：

   ps aux | grep simplenote-mcp
   

2. 重新启动Claude Desktop和服务器：

   ./simplenote_mcp/scripts/restart_claude.sh
   

3. 验证工具是否注册：

   ./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无法连接。

解决方法：

1. 查看日志文件：

   cat simplenote_mcp/logs/server.log
   

2. 检查Python版本：

   python --version
   

3. 确认安装是否正确：

   which simplenote-mcp-server
   

Claude Desktop无法找到工具

症状：Claude提示没有访问到SimpleNote工具。

解决方法：

1. 重新启动Claude Desktop和服务器。
2. 使用以下命令验证工具注册状态：

   ./simplenote_mcp/scripts/verify_tools.sh
   

贡献指南

提交代码

请按照以下步骤提交代码：

1. 创建一个分支：

   git checkout -b feature/your-feature-name
   

2. 提交更改：

   git add .
   git commit -m "你的提交信息"
   

3. 推送到远程仓库并创建Pull Request。

问题报告

请按照以下格式报告问题：

• 问题描述：简要说明问题。
• 复现步骤：详细列出复现问题的步骤。
• 预期结果：说明期望的行为。
• 实际结果：说明发生的结果。

文档参考

• 《ROADMAP.md》
• 《LICENSE》
• 《CONTRIBUTING.md》