saga-event-space-mcp-server

佐賀県内のイベントスペース・ホテル・懇親会会場情報を管理する Saga Event Space API の MCP（Model Context Protocol）サーバです。

Claude Desktop、Kiro-CLI（Amazon Q Developer for CLI）などの MCP クライアントから利用できます。

利用可能なツール

検索・参照

ツール名	説明
search_places	会場をキーワード・カテゴリ・設備条件で検索
get_place_detail	指定IDの会場詳細取得
list_announcements	お知らせ一覧取得
list_release_notes	リリースノート一覧取得
get_release_note	リリースノート詳細取得
check_health	システム稼働状況確認

会場管理（APIトークン必須）

ツール名	説明
create_place	新規会場作成
update_place	会場情報更新
delete_place	会場削除
get_place_stats	ステータス統計
bulk_update_status	一括ステータス更新

お知らせ管理（APIトークン必須）

ツール名	説明
create_announcement	お知らせ作成
update_announcement	お知らせ更新
delete_announcement	お知らせ削除

リリースノート管理（APIトークン必須）

ツール名	説明
create_release_note	リリースノート作成
update_release_note	リリースノート更新
delete_release_note	リリースノート削除

管理機能（APIトークン必須）

ツール名	説明
get_audit_logs	監査ログ一覧取得
get_audit_log_stats	監査ログ統計取得
get_deletion_requests	削除申請一覧取得
approve_deletion_request	削除申請承認
reject_deletion_request	削除申請拒否
get_duplicates	重複報告一覧取得
report_duplicate	重複報告作成
resolve_duplicate	重複報告解決
merge_duplicate	重複会場マージ

ユーザー・認証管理（APIトークン必須）

ツール名	説明
get_users	ユーザー一覧取得
update_user_role	ユーザー権限更新
restore_user	削除ユーザー復元
get_tokens	APIトークン一覧取得
create_token	APIトークン発行
update_token	APIトークン名更新
delete_token	APIトークン削除

ユーティリティ

ツール名	説明
normalize_address	日本語住所の正規化
geocode	住所→緯度経度変換
get_upload_url	写真アップロード用URL取得（APIトークン必須）

セットアップ

npx で利用（推奨）

npx saga-event-space-mcp-server

ローカルビルド

git clone https://github.com/midnight480/saga-event-space-mcp-server.git
cd saga-event-space-mcp-server
npm install
npm run build
npm start

Docker で利用

docker run -i --rm \
  -e SAGA_EVENT_SPACE_API_TOKEN=your-api-token-here \
  midnight480/saga-event-space-mcp-server

MCP クライアント設定

Claude Desktop

claude_desktop_config.json に以下を追加してください。

npx の場合

{
  "mcpServers": {
    "saga-event-space": {
      "command": "npx",
      "args": ["-y", "saga-event-space-mcp-server"],
      "env": {
        "SAGA_EVENT_SPACE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Docker の場合

{
  "mcpServers": {
    "saga-event-space": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SAGA_EVENT_SPACE_API_TOKEN",
        "midnight480/saga-event-space-mcp-server"
      ],
      "env": {
        "SAGA_EVENT_SPACE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Kiro-CLI（Amazon Q Developer for CLI）

.kiro/settings.json にMCPサーバ設定を追加してください。

{
  "mcpServers": {
    "saga-event-space": {
      "command": "npx",
      "args": ["-y", "saga-event-space-mcp-server"],
      "env": {
        "SAGA_EVENT_SPACE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

環境変数

環境変数	必須	説明
SAGA_EVENT_SPACE_API_TOKEN	はい	APIアクセストークン（検索含む全操作に必要）
SAGA_EVENT_SPACE_BASE_URL	いいえ	APIのベースURL（デフォルト: https://saga-event-space.midnight480.com）

開発

# 依存関係のインストール
npm install

# 開発モード（TypeScript ウォッチ）
npm run dev

# ビルド
npm run build

# MCP Inspector でテスト
npx @modelcontextprotocol/inspector node dist/index.js

ライセンス

MIT