Sola MCP Server

# Sola MCP Server A stateless, streamable HTTP server implementing the [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol) for the Social Layer platform. This server exposes a set of tools for interacting with events, groups, profiles, and venues via HTTP endpoints. ## Features - **MCP server** for Social Layer integrations - Exposes tools for: - Event retrieval (`event/get`) - Event listing and search (`event/list`, `event/search`) - Group info (`group/get`) - Profile info (`profile/get`) - Venue info (`venue/get`) - Stateless, session-based HTTP transport - Ready for deployment on [Fly.io](https://fly.io/) ## Getting Started ### Prerequisites - [Bun](https://bun.sh/) (for running and installing dependencies) - Node.js (for compatibility with some dependencies) - [Fly.io](https://fly.io/) account (for deployment, optional) ### Installation ```bash bun install ``` ### Running the Server ```bash bun run index.ts ``` The server will start on port `3000` by default. ### Inspecting the MCP Server You can inspect the running server using the MCP Inspector: ```bash bunx @modelcontextprotocol/inspector http://localhost:3000/mcp/public ``` ## API Endpoints - `POST /mcp/public` — Main endpoint for MCP client-to-server communication - `GET /mcp/public` — Server-to-client notifications via SSE - `DELETE /mcp/public` — Session termination All endpoints expect and return JSON-RPC 2.0 payloads. ## Tooling The following tools are available via the MCP protocol: - `event/get`: Get event details by ID - `event/list`: List events for a group and date range - `event/search`: Search events by keyword - `group/get`: Get group details - `profile/get`: Get profile details - `venue/get`: Get venue details ## Deployment This project is ready to deploy on [Fly.io](https://fly.io/): 1. Install the [Fly CLI](https://fly.io/docs/hands-on/install-flyctl/) 2. Authenticate: `fly auth login` 3. Launch: `fly launch` 4. Deploy: `fly deploy` The `fly.toml` is preconfigured for deployment. ## Development - Format code: `bun run format` - Check formatting: `bun run format:check` ## License MIT ## Author jiangplus