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電子郵件地址。
• 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》