Sola MCP

🚀 Sola MCP 服務器

Sola MCP 服務器是一個無狀態、可流式傳輸的 HTTP 服務器，它為 Social Layer 平臺實現了 模型上下文協議 (MCP)。該服務器通過 HTTP 端點提供了一組用於與事件、群組、個人資料和場地進行交互的工具。

🚀 快速開始

前提條件

• Bun（用於運行和安裝依賴項）
• Node.js（為了與某些依賴項兼容）
• Fly.io 賬戶（用於部署，可選）

📦 安裝指南

bun install

運行服務器

bun run index.ts

服務器默認將在端口 3000 上啟動。

檢查 MCP 服務器

你可以使用 MCP 檢查器來檢查正在運行的服務器：

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

✨ 主要特性

• 用於 Social Layer 集成的 MCP 服務器
• 提供以下工具：
  • 事件檢索 (event/get)
  • 事件列表和搜索 (event/list, event/search)
  • 群組信息 (group/get)
  • 個人資料信息 (profile/get)
  • 場地信息 (venue/get)
• 無狀態、基於會話的 HTTP 傳輸
• 可在 Fly.io 上隨時部署

📚 詳細文檔

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