Odsbox Jaquel MCP

🚀 ODS Jaquel MCP開發容器

本開發容器為ODS Jaquel MCP項目提供了一個完全配置好的Python 3.13開發環境。

✨ 主要特性

• Python 3.13：pyproject.toml中指定的最新穩定Python版本。
• Git集成：預安裝，用於版本控制。
• VS Code擴展：包含Pylance、調試器、Black格式化器和Ruff lint工具等Python開發工具。
• 預配置環境：
  • 項目以可編輯模式安裝（pip install -e .）。
  • 開發依賴已安裝（pip install -e '.[dev]'）。
  • 已配置Python格式化和代碼檢查。
  • 已配置Pytest測試。

🚀 快速開始

1. 在開發容器中打開項目

• 在VS Code中打開項目文件夾。
• 運行：Dev Containers: Reopen in Container（Cmd/Ctrl + Shift + P）。

2. 驗證安裝

python --version
python -m pytest tests/ -v

3. 運行服務器

python -m odsbox_jaquel_mcp

4. 構建軟件包

python -m build

📚 詳細文檔

開發工作流程

• 格式化代碼：使用black .或VS Code的“格式化文檔”功能。
• 代碼檢查：運行flake8 .。
• 類型檢查：運行mypy odsbox_jaquel_mcp/。
• 運行測試：按Ctrl + Shift + D打開測試資源管理器，或運行pytest tests/ -v。
• 調試：設置斷點並使用VS Code調試器（F5）。

SSH訪問

本地SSH密鑰以只讀方式掛載，用於Git身份驗證。這允許在容器內無縫進行Git操作。

故障排除

• 端口轉發：如果要連接到ODS服務器，請在VS Code中使用端口轉發。
• 依賴項：如果需要額外的軟件包，請運行pip install -r requirements.txt。
• 重建容器：關閉開發容器，然後使用Dev Containers: Rebuild Container進行重建。