Tideways

io.github.abuhamzav2.0.0更新於 Oct 3, 2026

Read-only access to Tideways PHP performance monitoring: performance, issues, traces, history.

已驗證STDIO僅桌面Security & MonitoringData & Analytics

概覽

AI 產生的概覽

唯讀存取 Tideways PHP 效能監控，讓助理查詢效能、問題、追蹤與歷史資料。

功能
僅使用 GET 端點包裝 Tideways REST API，因此助理可以回答諸如「昨天結帳為什麼變慢」之類的問題。工具涵蓋列出專案與服務、最長 24 小時視窗內的效能總量與分層、最長 30 天的 15 分鐘效能摘要、未解決或已解決的問題、慢速請求追蹤、按日/週/月的歷史報告，以及偵測到的設定問題與程式碼瓶頸（例如 N+1 查詢）。
適用情境
當你已經使用 Tideways 監控 PHP 應用程式，並希望助理在不開啟 Tideways 介面的情況下排查慢速請求、錯誤、慢速 SQL、棄用警告或歷史趨勢時適用。它是唯讀的，因此不適合修改監控設定或應用程式碼。
執行需求
需要一個具備 metrics、traces 與 errors 權限範圍的 Tideways API 權杖，透過 TIDEWAYS_TOKEN 環境變數提供。可透過 npx 搭配 Node.js 22+ 在本機執行，也可用 Docker 或 Claude Desktop 的 .mcpb 套件執行。選用變數可設定預設專案、組織、環境、服務、API 基礎網址、請求逾時與日誌層級。需要能連線至 Tideways API 的網路。
安裝前請注意
必需的 TIDEWAYS_TOKEN 是授予 Tideways 效能資料（包含追蹤與錯誤）讀取權限的憑證，應存放在用戶端的密鑰管理中，而不是共用設定裡。所有工具皆為唯讀，不會寫入、傳送或刪除任何內容。API 速率限制依權杖與整點小時計算，並在所有專案間共用，部分工具每個服務會消耗一次請求。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Tideways，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Tideways MCP Server

[npm] [CI] [OpenSSF Scorecard]

A read-only Model Context Protocol server for Tideways. It lets an AI assistant answer questions such as "why was checkout slow yesterday?" from your performance data, issues and traces. It only calls GET endpoints of the Tideways REST API.

Install

You need a Tideways API token with the scopes metrics, traces and errors (Organization settings → API Access), and Node.js 22+ or Docker. Coming from 1.x? See UPGRADING.md.

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

Add -s user to use it in every project.

Claude Desktop

Open the .mcpb bundle from the latest release. It asks for the token and keeps it in the OS keychain.

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

The Codex CLI, IDE extension and app share this entry in ~/.codex/config.toml.

Cursor, Gemini CLI and other clients

Add to the client's MCP configuration (Cursor: ~/.cursor/mcp.json; Gemini CLI: ~/.gemini/settings.json; either also per project):

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

Add to .vscode/mcp.json, or run MCP: Open User Configuration for all workspaces. VS Code asks for the token on first start and stores it.

json
{  "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

In any setup above, replace npx -y tideways-mcp-server with docker run -i --rm -e TIDEWAYS_TOKEN ghcr.io/abuhamza/tideways-mcp-server (pin a version with :2.0.0). For example:

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

Tools

ToolAnswers
tideways_list_projectsWhich projects, scopes and rate-limit budget does my token have?
tideways_list_servicesWhich services does a project have, and which of them serve "voucher"?
tideways_get_performanceHow is the app doing in any window of up to 24 h within the last ~30 days? Totals, layers, top transactions
tideways_get_performance_summaryRequests, errors and p95 in 15-minute buckets over up to 30 days
tideways_list_issuesWhich errors, slow SQL queries or deprecations are open, resolved or ignored?
tideways_search_tracesWhich individual requests were slow, and where did the time go?
tideways_get_historyDay, week or month report for a past date
tideways_get_observationsConfiguration problems and code bottlenecks Tideways detected (e.g. N+1 queries)

All tools except tideways_list_projects take an optional project (name or organization/name).

Configuration

Environment variables; empty values count as unset. The server does not load .env files.

VariableDefaultMeaning
TIDEWAYS_TOKENrequiredAPI token
TIDEWAYS_PROJECTthe token's only projectDefault project; with several projects and no default, pass project per call
TIDEWAYS_ORGfrom the token's projectsOrganization, to match a plain project name
TIDEWAYS_ENVAPI defaultDefault environment
TIDEWAYS_SERVICEthe project's default serviceDefault service
TIDEWAYS_BASE_URLhttps://app.tideways.io/apps/apiAPI base URL, https only
TIDEWAYS_REQUEST_TIMEOUT30000Request timeout in ms, a positive integer up to 600000
LOG_LEVELinfodebug, info, warn or error, case-insensitive; logs go to stderr

Good to know

  • All times are UTC, YYYY-MM-DD HH:mm. The API rate limit is per token and clock hour, shared by all projects.
  • Tools read the project's default service unless you name one. The API cannot list services; tideways_list_services finds them through open issues, and its search costs one request per service.
  • Limits of the Tideways API: at most 30 traces per search, history for production and the default service only, issues 10 per page, and no trace filter by bottleneck (an N+1 observation's link opens the affected traces in Tideways).

Security

The token is read from the environment and never logged, and trace URLs are returned without query strings. Report vulnerabilities privately as described in SECURITY.md.

Development

bash
npm cinpm run typecheck && npm run lint && npm run format:check && npm test   # the gatenpm run build && npm run inspect                                        # try the tools in the MCP Inspector

Architecture, invariants and how to add a tool: CLAUDE.md. Commits follow Conventional Commits.

License

MIT

來源：README.md，提交 98c1714

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v2.0.0最新Oct 3, 2026