Surfa MCP

MCP数据服务

提供方 gamladz

数据服务 未标注 会话登录 社区 / 第三方 Claude DesktopClaude

Surfa MCP Server是一款通过自然语言查询分析数据的服务,支持AI驱动的数据洞察和多查询工作流,适用于产品经理和DevOps团队。

一句话选型结论

按资料字段整理

Surfa MCP 属于数据服务类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

数据分析Python本地部署自然语言处理AI代理性能分析多租户

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Surfa MCP当前 4 未标注 未标注 无 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方gamladz上游标注的维护方 gamladz
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

4.1 KB
来自项目仓库与上游目录的原文,未做删改

Surfa MCP服务器

查询您的 Surfa分析 通过Claude Desktop、ChatGPT或任何兼容MCP的客户端使用自然语言存储数据。

通过人工智能将您的分析转化为洞察力:

  • 问“我的成功率是多少?”→ 获得即时答案
  • “查找昨天的所有错误”→ 筛选事件列表
  • “分析我的产品健康状况”→ 基于人工智能的推荐

非常适合产品经理、DevOps团队和任何使用MCP构建的人。

特性

  • 🔍 查询事件 -过滤和搜索您的实时流量事件
  • 📊 分析指标 -获取高级指标(会话、成功率、延迟)
  • ⚡ 性能分析 -查找延迟最高的查询
  • 🔎 深度潜水课程 -详细调查具体会议
  • 🤖 PM代理就绪 -针对AI代理消费优化的JSON响应
  • 🔗 多查询工作流 -将查询链接在一起进行复杂分析

安装```bash

cd packages/mcp-server
uv pip install -e .


## 配置

创建一个 `.env` 文件:```bash
SURFA_API_KEY=sk_live_your_key_here
SURFA_API_URL=https://surfa-web.vercel.app
SURFA_TIMEOUT=30

用法

选项1:本地(克劳德桌面)

添加到您的 claude_desktop_config.json:```json
{
"mcpServers": {
"surfa": {
"command": "uv",
"args": [
"--directory",
"/path/to/surfa/packages/mcp-server",
"run",
"surfa-mcp"
],
"env": {
"SURFA_API_KEY": "sk_live_your_key_here",
"SURFA_API_URL": "https://surfa-web.vercel.app"
}
}
}
}


### 选项2:远程(托管在Fly.io上)-多租户

公共Surfa MCP部署在 `https://surfa-mcp.fly.dev` 并支持多个用户。

**每个用户都提供自己的API密钥:**```json
{
"mcpServers": {
"surfa": {
"url": "https://surfa-mcp.fly.dev",
"env": {
"SURFA_API_KEY": "sk_live_your_key_here"
}
}
}
}

优点:

  • ✅ 无需部署-使用公共实例
  • ✅ 自动缩放-仅在使用时运行
  • ✅ 安全-您的API密钥保留在您的计算机上
  • ✅ Dogfooded-跟踪所有使用情况以进行分析

看 部署.md 用于部署您自己的实例。

重新启动Claude Desktop并开始查询您的分析!

可用工具

1. get_analytics

获取高级分析指标。

例子:```
"Show me my analytics overview"


**退货:**```json
{
"ok": true,
"data": {
"totalSessions": 150,
"successRate": 85,
"avgExecutionTime": 245,
"activeSessions": 12
}
}

2. query_events

使用筛选器查询事件。

例子:```
"Show me all errors from the last 24 hours"
"Find tool calls with latency over 1000ms"


**参数:**

- `tool_name` -按工具名称筛选
- `min_latency` / `max_latency` -延迟范围(毫秒)
- `start_date` / `end_date` -ISO 8601时间戳
- `kind` -事件类型(工具、会话、运行时)
- `status` -事件状态(成功、错误)
- `limit` -最大结果(默认值:100)

### 3. `find_highest_latency`

查找时间范围内最慢的查询。

**例子:**```
"What were the slowest queries this week?"

参数:

  • time_range -小时、日、周或月
  • tool_name -可选:按工具筛选
  • limit -结果数(默认值:10)

4. get_session

获取详细的会话信息。

例子:```
"Show me details for session abc123"


**参数:**

- `session_id` -要检索的会话ID

## 多查询工作流

PM Agent可以将查询链接在一起:

**工作流程示例:**

1. 获取分析→ 成功率低
1. 通过以下方式查询事件 `status=error` → 查找错误
1. 获取会话详细信息→ 调查具体故障

所有响应都是JSON格式,便于AI代理解析。

## 狗食(跟踪您自己的MCP使用情况)

想在Surfa中查看您自己的MCP服务器使用情况吗?通过添加摄取密钥启用分析:```bash
# Add to .env
SURFA_INGEST_KEY=sk_live_your_ingest_key_here

这将跟踪:

  • ✅ 工具调用(get_analytics、query_events等)
  • ✅ 每个工具的延迟
  • ✅ 成功/失败率
  • ✅ 会话分析

所有工具调用都将显示在您的Surfa仪表板上,让您分析自己的MCP服务器性能!

发展

运行测试:```bash
pytest tests/


格式代码:```bash
black src/
ruff check src/

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Surfa MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Surfa MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Surfa MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Surfa MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Surfa MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Surfa MCP 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 数据分析、多租户、Python、Claude、性能分析。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。