Seren MCP 服务器使用说明

项目简介

Seren MCP 服务器是一个采用 Rust 语言开发的完整 MCP（Model Context Protocol）服务器实现，旨在为 AI 助手和其他 LLM 客户端提供结构化数据库管理、工具调用、身份认证与会话管理能力。它支持与 SerenDB（无服务器 PostgreSQL 平台）深度集成，允许通过标准 JSON-RPC 协议高效地管理数据库项目、分支、查询执行，以及接入第三方 Agent Store 资源，实现统一微支付及安全访问。

主要功能点

资源托管与管理：管理 SerenDB 数据库项目、分支、角色、端点等资源。
工具注册与调用：通过 MCP 工具接口调用数据库操作、API 请求以及本地钱包支付功能。
Prompt 模板与 Agent Store 支持：访问和调用智能代理模板、付费服务与资源。
多模式认证：支持静态 API 密钥认证、本地钱包签名支付，以及 OAuth 2.1 完整认证流程。
会话管理与持久化：支持基于 RMCP 的多协议传输（Stdio/SSE/WebSocket），并实现会话跨重启恢复。
支付功能集成：内置对 x402 加密支付协议的支持，可通过本地私钥支付 USDC 等代币。
安全与可扩展性：综合请求权限管理、读写模式控制、访问日志与指标追踪。
命令行工具和 SDK：提供 Rust SDK 与 CLI 方便本地开发和管理。

安装步骤

使用 Cargo 安装（推荐）
- 安装 CLI 工具：'cargo install seren-cli'
- 安装 MCP 服务器：'cargo install seren-mcp'
从源码构建
- 克隆仓库：'git clone https://github.com/serenorg/seren.git'
- 构建：'cargo build --release'
- 安装：分别进入 'cli' 和 'mcp' 目录执行 'cargo install --path .'
使用预构建二进制包
- 访问GitHub Releases下载对应平台版本。
通过 Homebrew (macOS/Linux) 安装
- 'brew install serenorg/tap/seren'

MCP 服务器配置说明

MCP客户端需要配置启动命令及参数以启动或连接 Seren MCP 服务器。以下提供示例说明：

{
  "mcpServers": {
    "seren": {
      "command": "npx",
      "args": ["-y", "seren-mcp@latest", "start:oauth"]
    }
  }
}

server name: '"seren"'，这是 MCPServer 的标识名。
command: 启动 MCP 服务的命令，如上示例使用 'npx' 运行最新包。
args：
- '"start:oauth"'：启动服务器的 OAuth 模式（推荐生产环境）。
- 也可用 '"start"'（stdio 本地模式）或 '"start:http"'（简易 HTTP 验证模式）。

环境变量配置（根据启动模式稍有不同）：

'API_KEY'：用于 'start' 和 'start:http' 模式，提供 Seren API 密钥。
'DATABASE_URL'、'PUBLIC_URL'：用于 'start:oauth' 模式，设置 PostgreSQL 连接和服务器公有地址。
'JWT_SECRET' 或 'JWT_SECRETS'：OAuth 模式使用 JWT 签名秘钥，保证安全认证。
'WALLET_PRIVATE_KEY'：本地钱包私钥，用于 x402 支付签名（仅 stdio 本地模式启用）。

基本使用方法

登录与管理项目
使用命令行工具进行认证和项目管理，如：

seren auth login
seren projects list
seren projects create --name my-project --region aws-us-east-1

调用 MCP 工具
通过 MCP 客户端发送 JSON-RPC 调用执行查询、数据库管理或调用 Agent Store 服务。
支付与余额管理
查询并充值 SerenBucks，或使用本地钱包进行链上支付。
利用 OAuth 认证
配置 OAuth 客户端，安全连接服务，支持会话恢复和刷新令牌。
访问文档与工具列表
访问服务器内置文档页面了解可用工具与资源接口。

详见仓库内 'mcp/README.md' 及官方文档 https://docs.serendb.com。

Seren MCP 服务器

Seren MCP 服务器 使用说明