Sola MCP

🚀 Sola MCP Server

Social Layerプラットフォーム用のModel Context Protocol (MCP)を実装した、ステートレスでストリーミング可能なHTTPサーバーです。このサーバーは、HTTPエンドポイントを介してイベント、グループ、プロファイル、会場とやり取りするための一連のツールを提供します。

✨ 主な機能

• Social Layer統合向けのMCPサーバー
• 以下の操作を行うためのツールを提供します：
  • イベントの取得 (event/get)
  • イベントの一覧表示と検索 (event/list, event/search)
  • グループ情報の取得 (group/get)
  • プロファイル情報の取得 (profile/get)
  • 会場情報の取得 (venue/get)
• ステートレスでセッションベースのHTTPトランスポート
• Fly.io へのデプロイが可能

🚀 クイックスタート

前提条件

• Bun（依存関係の実行とインストール用）
• Node.js（一部の依存関係との互換性用）
• Fly.io アカウント（デプロイ用、オプション）

📦 インストール

bun install

サーバーの起動

bun run index.ts

サーバーはデフォルトでポート 3000 で起動します。

MCPサーバーの検査

MCP Inspectorを使用して実行中のサーバーを検査できます。

bunx @modelcontextprotocol/inspector http://localhost:3000/mcp/public

📚 ドキュメント

APIエンドポイント

• POST /mcp/public — MCPのクライアントからサーバーへの通信のメインエンドポイント
• GET /mcp/public — SSEを介したサーバーからクライアントへの通知
• DELETE /mcp/public — セッションの終了

すべてのエンドポイントはJSON-RPC 2.0のペイロードを期待し、返します。

ツール

MCPプロトコルを介して以下のツールが利用可能です。

• event/get: IDでイベントの詳細を取得
• event/list: グループと日付範囲に基づいてイベントを一覧表示
• event/search: キーワードでイベントを検索
• group/get: グループの詳細を取得
• profile/get: プロファイルの詳細を取得
• venue/get: 会場の詳細を取得

デプロイ

このプロジェクトは Fly.io へのデプロイが可能です。

1. Fly CLI をインストール
2. 認証: fly auth login
3. 起動: fly launch
4. デプロイ: fly deploy

fly.toml はデプロイ用に事前に設定されています。

開発

• コードのフォーマット: bun run format
• フォーマットのチェック: bun run format:check

📄 ライセンス

MIT

作者

jiangplus