Postscript MCP Server

Postscript MCP サーバー

Postscript SMS マーケティングプラットフォーム API と連携するための MCP サーバーです。

## セットアップ

1. 依存関係をインストールします。
   ```
   npm install
   ```

2. API キーを設定します。
   - ルートディレクトリに `.env` ファイルを作成します
   - Postscript API キーを追加します：`POSTSCRIPT_API_KEY=your_api_key_here`

3. サーバーを実行します。
   ```
   npm run dev
   ```

4. MCP Inspector でテストします。
   ```
   npm run inspect
   ```

## 機能

この MCP サーバーでは、次の Postscript API 機能を利用できます。

- **ショップ**：Postscript のショップ情報を取得します
- **サブスクライバー**：SMS サブスクライバーを管理します（作成、更新、取得）
- **キャンペーン**：SMS キャンペーンを作成、取得します
- **メッセージ**：サブスクライバーにダイレクトメッセージを送信します
- **キーワード**：SMS キーワードを取得します

## 利用可能なツール

- `get_shops`：すべての Postscript ショップを取得します
- `get_shop`：ID で特定のショップを取得します
- `get_subscribers`：ショップのサブスクライバーを取得します
- `get_subscriber`：ID で特定のサブスクライバーを取得します
- `create_subscriber`：新しいサブスクライバーを作成します
- `update_subscriber`：既存のサブスクライバーを更新します
- `get_campaigns`：ショップのキャンペーンを取得します
- `create_campaign`：新しいキャンペーンを作成します
- `send_message`：サブスクライバーにダイレクトメッセージを送信します
- `get_keywords`：ショップのキーワードを取得します

## 利用可能なリソース

- `postscript://shops`：すべてのショップを一覧表示します
- `postscript://shops/{shopId}`：特定のショップを取得します
- `postscript://shops/{shopId}/subscribers`：ショップのサブスクライバーを一覧表示します
- `postscript://shops/{shopId}/subscribers/{subscriberId}`：特定のサブスクライバーを取得します
- `postscript://shops/{shopId}/campaigns`：ショップのキャンペーンを一覧表示します

## API ドキュメント

Postscript API の詳細については、以下を参照してください。
- [はじめに](https://developers.postscript.io/docs/getting-started)
- [API リファレンス](https://developers.postscript.io/reference/new-object-identifiers)