MCP协议服务器

一个无状态的、可流式传输的HTTP服务器,实现了Model Context Protocol (MCP),用于Social Layer平台,提供事件、群组、个人资料和场所的交互工具。

  • by sociallayer-im
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 sociallayer-im/sola-mcp

使用说明

Sola MCP服务器

一个无状态、可流式传输的HTTP服务器,实现 模型上下文协议(MCP) 社交层平台。此服务器公开了一组工具,用于通过HTTP端点与事件、组、配置文件和场所进行交互。

特性

  • MCP服务器 用于社交层集成
  • 展示以下工具:
    • 事件检索(event/get)
    • 事件列表和搜索(event/list, event/search)
    • 集团信息(group/get)
    • 个人资料信息(profile/get)
    • 场馆信息(venue/get)
  • 无状态、基于会话的HTTP传输
  • 已准备好部署 Fly.io

入门指南

先决条件

  • 包子 (用于运行和安装依赖项)
  • 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

许可证

麻省理工学院

作者

江浦