Odsbox Jaquel MCP

🚀 ODS Jaquel MCP開発コンテナ

この開発コンテナは、ODS Jaquel MCPプロジェクトのために完全に設定されたPython 3.13の開発環境を提供します。

✨ 主な機能

• Python 3.13：pyproject.tomlで指定された最新の安定版Pythonバージョン
• Git統合：バージョン管理のために事前にインストールされています
• VS Code拡張機能：Pylance、デバッガー、Blackフォーマッター、Ruffリンターを含むPython開発ツール
• 事前設定された環境：
  • プロジェクトが編集可能モードでインストールされます（pip install -e .）
  • 開発用の依存関係がインストールされます（pip install -e '.[dev]'）
  • Pythonのフォーマットとリントが設定されています
  • Pytestテストが設定されています

🚀 クイックスタート

開発コンテナで開く

• VS Codeでプロジェクトフォルダを開きます
• Dev Containers: Reopen in Container（Cmd/Ctrl+Shift+P）を実行します

インストールを確認する

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

サーバーを起動する

python -m odsbox_jaquel_mcp

パッケージをビルドする

python -m build

💻 使用例

基本的な使用法

コードのフォーマット

black .

またはVS Codeの「ドキュメントをフォーマット」機能を使用します。

リント

flake8 .

型チェック

mypy odsbox_jaquel_mcp/

テストの実行

Ctrl+Shift+Dを押してテストエクスプローラーを開くか、以下のコマンドを実行します。

pytest tests/ -v

デバッグ

ブレークポイントを設定し、VS Codeデバッガー（F5）を使用します。

🔧 技術詳細

ローカルのSSHキーはGit認証のために読み取り専用でマウントされています。これにより、コンテナ内でシームレスにGit操作を行うことができます。

トラブルシューティング

• ポート転送：ODSサーバーに接続する場合は、VS Codeでポート転送を使用してください
• 依存関係：追加のパッケージが必要な場合は、pip install -r requirements.txtを実行してください
• 再構築：開発コンテナを閉じて、Dev Containers: Rebuild Containerで再構築してください