sola-mcp

🚀 Sola MCP Server

Sola MCP Server是一个无状态、可流式传输的HTTP服务器，它为Social Layer平台实现了模型上下文协议（MCP）。该服务器通过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检查器来检查正在运行的服务器：

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