Tideways

Name: Tideways
Author: abuhamza

本地服务

github.com数据与分析31 周前更新

代码仓库访问官网

关于 Tideways

Tideways MCP Server 是非官方的只读连接器，用于访问 Tideways 的 PHP 性能数据。它面向通过 AI 助手排查应用性能、错误和请求追踪的团队，使用 Tideways REST API 的 GET 端点。

主要功能

01读取性能指标和汇总数据
02检查事务及响应时间历史
03列出并查看问题
04搜索缓慢请求追踪
05获取历史报告和观测结果

适用场景

01调查前一天变慢的事务
02查看各服务的错误和慢 SQL
03定位单个请求的耗时位置

MCP 相关

该 MCP 服务提供工具，用于查询 Tideways 项目、服务、性能指标、问题、追踪、历史记录和观测结果。所有 API 访问均为只读，并使用 GET 端点。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

安装包

npmtideways-mcp-server2.1.1stdio

ocighcr.io/abuhamza/tideways-mcp-server:2.1.1stdio

mcpbtideways-mcp-server-2.1.1.mcpbstdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Tideways MCP 服务

这是一个由社区维护的非官方服务，与 Tideways 无关联，也不受其支持。如需使用 Tideways 自己的工具，请参阅官方的 Tideways CLI。

这是一个面向 Tideways 的只读 Model Context Protocol 服务。它可以让 AI 助手根据性能数据、问题和跟踪记录，回答“为什么昨天结账很慢？”之类的问题。它只会调用 Tideways REST API 的 GET 端点。

安装

你需要一个具有 metrics、traces 和 errors 范围的 Tideways API 令牌（组织设置 → API 访问权限），以及 Node.js 22+ 或 Docker。正在从 1.x 升级？请参阅 UPGRADING.md。

Claude Code

claude mcp add tideways -e TIDEWAYS_TOKEN=your-token -- npx -y tideways-mcp-server

添加 -s user 即可在每个项目中使用。

Claude Desktop

打开最新版本中的 .mcpb 安装包。它会要求你提供令牌，并将其保存在操作系统的钥匙串中。

Codex

codex mcp add tideways --env TIDEWAYS_TOKEN=your-token -- npx -y tideways-mcp-server

Codex CLI、IDE 扩展和应用共用 ~/.codex/config.toml 中的此条目。

Cursor、Gemini CLI 和其他客户端

将以下内容添加到客户端的 MCP 配置中（Cursor：~/.cursor/mcp.json；Gemini CLI：~/.gemini/settings.json；也可以分别为每个项目配置）：

{
  "mcpServers": {
    "tideways": {
      "command": "npx",
      "args": ["-y", "tideways-mcp-server"],
      "env": { "TIDEWAYS_TOKEN": "your-token" }
    }
  }
}

OpenCode

将以下内容添加到项目中的 opencode.json，或添加到 ~/.config/opencode/opencode.json 以供所有项目使用。{env:TIDEWAYS_TOKEN} 会从 shell 环境中读取令牌。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tideways": {
      "type": "local",
      "command": ["npx", "-y", "tideways-mcp-server"],
      "environment": { "TIDEWAYS_TOKEN": "{env:TIDEWAYS_TOKEN}" }
    }
  }
}

VS Code

将以下内容添加到 .vscode/mcp.json，或运行 MCP: Open User Configuration 以供所有工作区使用。VS Code 会在首次启动时要求你提供令牌并将其保存。

{
  "inputs": [
    { "type": "promptString", "id": "tideways-token", "description": "Tideways API token", "password": true }
  ],
  "servers": {
    "tideways": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tideways-mcp-server"],
      "env": { "TIDEWAYS_TOKEN": "${input:tideways-token}" }
    }
  }
}

Docker

在上述任意配置中，将 npx -y tideways-mcp-server 替换为 docker run -i --rm -e TIDEWAYS_TOKEN ghcr.io/abuhamza/tideways-mcp-server（使用 :2.0.0 固定版本）。例如：

claude mcp add tideways -e TIDEWAYS_TOKEN=your-token -- docker run -i --rm -e TIDEWAYS_TOKEN ghcr.io/abuhamza/tideways-mcp-server

"command": "docker",
"args": ["run", "-i", "--rm", "-e", "TIDEWAYS_TOKEN", "ghcr.io/abuhamza/tideways-mcp-server"],
"env": { "TIDEWAYS_TOKEN": "your-token" }

## 工具

工具	可回答的问题
`tideways_list_projects`	我的令牌可访问哪些项目和范围？每小时速率限制还剩多少？
`tideways_list_services`	项目有哪些服务？其中哪些服务提供“voucher”？
`tideways_get_performance`	应用在过去约 30 天内任意不超过 24 小时的时间段中表现如何？包括总量、各层和排名靠前的事务
`tideways_get_transaction`	某个事务何时变慢，发生在哪一层？包括按分钟划分的时间线和响应时间直方图
`tideways_get_performance_summary`	最长 30 天内按 15 分钟分桶的请求数、错误数和 p95
`tideways_list_issues`	任意服务或事务中有哪些错误、慢 SQL 查询、弃用、警告或通知处于未解决、已解决或已忽略状态？
`tideways_get_issue`	问题在代码中的哪个位置出错？影响哪些事务？何时开始或停止？
`tideways_search_traces`	任意事务中哪些单个请求比较慢？时间花在了哪里？
`tideways_get_history`	过去某个日期的日、周或月报告
`tideways_get_observations`	Tideways 检测到的配置问题和代码瓶颈（例如 N+1 查询）

除 tideways_list_projects 外，所有工具都接受可选的 project（name 或 organization/name）。

配置

环境变量；空值视为未设置。服务不会加载 .env 文件。

变量	默认值	含义
`TIDEWAYS_TOKEN`	必填	API 令牌
`TIDEWAYS_PROJECT`	令牌唯一关联的项目	默认项目；如果有多个项目且未设置默认项目，则每次调用时传入 `project`
`TIDEWAYS_ORG`	根据令牌关联的项目确定	用于匹配普通项目名称的组织
`TIDEWAYS_ENV`	API 默认值	默认环境
`TIDEWAYS_SERVICE`	项目的默认服务	默认服务
`TIDEWAYS_BASE_URL`	`https://app.tideways.io/apps/api`	API 基础 URL，仅支持 https
`TIDEWAYS_REQUEST_TIMEOUT`	`30000`	请求超时时间，单位为 ms；必须是大于 0 且不超过 `600000` 的整数
`LOG_LEVEL`	`info`	`debug`、`info`、`warn` 或 `error`，不区分大小写；日志写入 stderr

注意事项

所有时间均为 UTC，格式为 YYYY-MM-DD HH:mm。API 速率限制按 Tideways 组织和时钟小时计算；限制额度取决于套餐，同一组织的所有令牌和项目共用该额度。
工具读取项目的默认服务，除非你指定服务；tideways_list_issues 会读取所有服务。API 无法列出服务；tideways_list_services 会通过检查所有服务的问题来查找服务，其 search 每个服务会消耗一次请求。
tideways_search_traces 每次调用返回 30 条追踪记录，使用 limit 最多可返回 100 条。
Tideways API 的限制：历史数据仅支持生产环境和默认服务；问题列表每页最多 10 条；无法按瓶颈筛选追踪记录（N+1 观察结果中的链接会在 Tideways 中打开受影响的追踪记录）。

安全

令牌从环境中读取，绝不会写入日志；返回的追踪 URL 不包含查询字符串。请按照 SECURITY.md 中的说明私下报告漏洞。

开发

npm ci
npm run check                      # the gate: typecheck, lint, format, tests, commit messages
npm run build && npm run inspect   # try the tools in the MCP Inspector

架构、不变量以及如何添加工具：CLAUDE.md。提交遵循 Conventional Commits。