Tideways について
Tideways MCP Serverは、TidewaysのPHPパフォーマンスデータにアクセスする非公式の読み取り専用コネクターです。Tideways REST APIのGETエンドポイントを使い、AIアシスタントで性能、エラー、トレースを調査するチーム向けです。
主な機能
- 01パフォーマンス指標と概要の取得
- 02トランザクションと応答時間履歴の確認
- 03問題の一覧表示と詳細確認
- 04遅いリクエストのトレース検索
- 05履歴レポートと観測結果の取得
活用シーン
- 01前日に遅くなったトランザクションの調査
- 02サービス全体のエラーや遅いSQLの確認
- 03個々のリクエストの処理時間の特定
MCP 対応
MCPサーバーは、Tidewaysのプロジェクト、サービス、性能指標、問題、トレース、履歴、観測結果を照会するツールを提供します。APIへのアクセスはすべて読み取り専用で、GETエンドポイントを使用します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
10掲載時のツール一覧 · 2 週間前に更新
このツールにパラメーターはありません。
詳細
Tideways MCP サーバー
Tideways とは提携しておらず、サポートも受けていない、非公式のコミュニティ運営サーバーです。Tideways 公式のツールについては、公式の Tideways CLI をご覧ください。
Tideways 用の読み取り専用 Model Context Protocol サーバーです。パフォーマンスデータ、問題、トレースをもとに、AI アシスタントが「昨日、チェックアウトが遅かったのはなぜですか?」といった質問に回答できるようにします。Tideways REST API の GET エンドポイントのみを呼び出します。
インストール
metrics、traces、errors スコープを持つ Tideways API トークン(Organization settings → API Access)と、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 バンドルを開いてください。トークンの入力を求められ、OS のキーチェーンに保存されます。
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} は、シェルの環境からトークンを読み込みます。
{
"$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 | トークンで利用できるプロジェクトとスコープは何ですか?また、1 時間あたりのレート制限はどれくらい残っていますか? |
tideways_list_services | プロジェクトにはどのサービスがあり、そのうち「voucher」を提供しているのはどれですか? |
tideways_get_performance | 過去約 30 日以内の最大 24 時間の任意の期間で、アプリのパフォーマンスはどうなっていますか?合計、レイヤー、上位のトランザクションを確認できます。 |
tideways_get_transaction | あるトランザクションが遅くなったのはいつで、どのレイヤーが原因ですか?分単位のタイムラインと応答時間のヒストグラムを確認できます。 |
tideways_get_performance_summary | 最大 30 日間のリクエスト数、エラー数、p95 を 15 分単位で確認できます。 |
tideways_list_issues | どのサービスまたはトランザクションで、どのエラー、遅い SQL クエリ、非推奨項目、警告、通知が未解決、解決済み、または無視されていますか? |
tideways_get_issue | 問題がコードのどこで発生し、どのトランザクションに影響し、いつ始まり、いつ止まりましたか? |
tideways_search_traces | どのトランザクションで個々のリクエストが遅く、その時間はどこで費やされましたか? |
tideways_get_history | 過去の日付の、日次、週次、または月次レポートを確認できます。 |
tideways_get_observations | Tideways が検出した設定上の問題やコードのボトルネック(例:N+1 クエリ)を確認できます。 |
project(name または organization/name)を指定できます。tideways_list_projects 以外のすべてのツールで任意です。
設定
環境変数。空の値は未設定として扱われます。このサーバーは .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 | リクエストのタイムアウト(ミリ秒)。600000 以下の正の整数 |
LOG_LEVEL | info | debug、info、warn、error のいずれか。大文字と小文字は区別されません。ログは stderr に出力されます |
知っておくとよいこと
- 時刻はすべて UTC の
YYYY-MM-DD HH:mm形式です。API のレート制限は Tideways の組織ごとに 1 時間単位で適用されます。上限はプランによって異なり、組織内のすべてのトークンとプロジェクトで共有されます。 - ツールは、サービスを指定しない場合はプロジェクトのデフォルトサービスを読み込みます。
tideways_list_issuesはすべてのサービスを読み込みます。API ではサービスの一覧を取得できません。tideways_list_servicesはすべてのサービスの問題を通じてサービスを見つけます。また、searchはサービスごとに 1 回のリクエストを消費します。 tideways_search_tracesは呼び出しごとに 30 件のトレースを返します。limitを指定すると最大 100 件まで返します。- Tideways API の制限:履歴を取得できるのは本番環境とデフォルトサービスのみです。問題は 1 ページあたり 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 に従います。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。