mcpField
T
Tideways

Tideways

ローカル
github.comデータ・分析31 週間前に更新

Tideways について

Tideways MCP Serverは、TidewaysのPHPパフォーマンスデータにアクセスする非公式の読み取り専用コネクターです。Tideways REST APIのGETエンドポイントを使い、AIアシスタントで性能、エラー、トレースを調査するチーム向けです。

主な機能

  1. 01パフォーマンス指標と概要の取得
  2. 02トランザクションと応答時間履歴の確認
  3. 03問題の一覧表示と詳細確認
  4. 04遅いリクエストのトレース検索
  5. 05履歴レポートと観測結果の取得

活用シーン

  1. 01前日に遅くなったトランザクションの調査
  2. 02サービス全体のエラーや遅いSQLの確認
  3. 03個々のリクエストの処理時間の特定

MCP 対応

MCPサーバーは、Tidewaysのプロジェクト、サービス、性能指標、問題、トレース、履歴、観測結果を照会するツールを提供します。APIへのアクセスはすべて読み取り専用で、GETエンドポイントを使用します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

インストール方法は未掲載です

このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。

リポジトリ
パッケージ
npmtideways-mcp-server2.1.1
ocighcr.io/abuhamza/tideways-mcp-server:2.1.1
mcpbtideways-mcp-server-2.1.1.mcpb

ツール

10

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

Tideways MCP サーバー

npm CI OpenSSF Scorecard

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_observationsTideways が検出した設定上の問題やコードのボトルネック(例:N+1 クエリ)を確認できます。

project(name または organization/name)を指定できます。tideways_list_projects 以外のすべてのツールで任意です。

設定

環境変数。空の値は未設定として扱われます。このサーバーは .env ファイルを読み込みません。

変数デフォルト説明
TIDEWAYS_TOKEN必須API トークン
TIDEWAYS_PROJECTトークンに紐づく唯一のプロジェクトデフォルトのプロジェクト。複数のプロジェクトがあり、デフォルトがない場合は、呼び出しごとに project を指定してください
TIDEWAYS_ORGトークンのプロジェクトから取得通常のプロジェクト名との照合に使う組織
TIDEWAYS_ENVAPI のデフォルトデフォルトの環境
TIDEWAYS_SERVICEプロジェクトのデフォルトサービスデフォルトのサービス
TIDEWAYS_BASE_URLhttps://app.tideways.io/apps/apiAPI のベース URL。https のみ
TIDEWAYS_REQUEST_TIMEOUT30000リクエストのタイムアウト(ミリ秒)。600000 以下の正の整数
LOG_LEVELinfodebug、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 に従います。

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。