Ebl MCP Server

## 🚀 EBL MCP サーバー

このプロジェクトは、電子船荷証券（eBLs）を管理するための**モデルコンテキストプロトコル (MCP)** サーバーを実装しています。eBLs の発行、照会、譲渡、および引き渡しの機能を提供します。

## 🚀 クイックスタート
### 前提条件
* Node.js (LTS バージョンを推奨)
* pnpm (`npm install -g pnpm` でインストール)

### インストール
1. リポジトリをクローンします:
    ```bash
    git clone <your-repo-url>
    cd ebl-mcp-server
    ```
2. 依存関係をインストールします:
    ```bash
    pnpm install
    ```

### サーバーの起動
* **開発モード:**
    ```bash
    pnpm dev
    ```
* **本番モード:**
    ```bash
    pnpm build
    pnpm start
    ```
    *(注意: ビルドと起動スクリプトは `package.json` で定義する必要があります)*

## ✨ 主な機能
* **eBL の発行:** 新しい電子船荷証券を作成して登録します。
* **eBL の照会:** 既存の eBL の詳細情報を取得します。
* **eBL の譲渡:** eBL の所持者/所有者を変更します。
* **eBL の引き渡し:** eBL を引き渡し済みとしてマークします。通常は貨物の引き渡し時に行います。

## 📦 インストール
### 前提条件
* Node.js (LTS バージョンを推奨)
* pnpm (`npm install -g pnpm` でインストール)

### 手順
1. リポジトリをクローンします:
    ```bash
    git clone <your-repo-url>
    cd ebl-mcp-server
    ```
2. 依存関係をインストールします:
    ```bash
    pnpm install
    ```

## 🔧 技術詳細
### 技術スタック
* **言語:** TypeScript
* **パッケージマネージャー:** pnpm
* **ランタイム:** Node.js
* **フレームワーク:** @modelcontextprotocol/sdk

### プロジェクト構造 (初期案)

ebl-mcp-server/ ├── src/ │ ├── index.ts # アプリケーションのメインエントリーポイント │ ├── routes/ # API ルート定義 │ ├── controllers/ # リクエストハンドラー │ ├── services/ # ビジネスロジック │ ├── models/ # データモデル/インターフェイス（例: eBL 構造） │ ├── middleware/ # カスタムミドルウェア（認証、ログなど） │ └── config/ # 設定ファイル ├── test/ # 単体テストと統合テスト ├── .env.example # 環境変数テンプレート ├── .gitignore ├── package.json ├── pnpm-lock.yaml ├── tsconfig.json ├── README.md # このファイル └── PLAN.md # 開発計画

## 🔗 貢献
当プロジェクトへの貢献を歓迎します！以下のガイドラインに従って、スムーズなコラボレーションを確保してください。

### 開発ワークフロー
1. リポジトリをフォークし、`main` ブランチから機能ブランチを作成します。
2. 依存関係をインストールします: `pnpm install`
3. コーディング規約に従って変更を加えます。
4. 新しい機能に対するテストを追加します。
5. テストを実行して、すべてが正常に動作することを確認します。
6. プルリクエストを提出します。

### コーディング規約
- 適切な型定義を持つ TypeScript でコードを記述します。
- 関数型プログラミングパラダイムに従い、クラスの使用を避けます。
- すべての関数が純粋で、可能な限り副作用がないようにします。
- 説明的な変数名を使用し、補助動詞を追加します（例: isLoading, hasError）。
- ファイル構造: コンポーネント、子コンポーネント、ヘルパー、および静的コンテンツをエクスポートします。
- @modelcontextprotocol/sdk のメカニズムを使用して、完全なエラーハンドリングを実装します。

### プルリクエストの流れ