Vynix MCP Server : AI-Powered Website Feedback & Bug Reporting

Vynix MCP サーバー

Vynix 用の Model Context Protocol サーバーです。コーディングエージェントが視覚的なフィードバック、バグ報告、スクリーンショット、診断情報、コメント、課題のワークフローに直接アクセスできるようにし、推測ではなく実際のコンテキストに基づいて判断できるようにします。

Vynix を選ぶ理由

• 根拠のあるフィードバック：ページのメタデータ、対象要素、スクリーンショット、コンソール／ネットワークのコンテキストを提供します。
• エンドツーエンドの実行：フィードバックの確認、診断、コーディングプロンプトの生成、GitHub の課題作成、ステータスの更新、コメントの追加を行えます。
• エージェントに安全なヒント：読み取り専用／冪等／オープンワールドのアノテーションにより、MCP クライアントでの承認動作を改善します。
• 最新の MCP ディレクトリに対応した、レジストリー向けメタデータを備えています。

アーキテクチャ

flowchart LR
  A[MCP Client\nClaude/Cursor/Copilot/VS Code] -->|stdio or streamable-http| B[Vynix MCP Server]
  B --> C[Vynix API]
  B --> D[GitHub API via Vynix backend]
  C --> E[Projects]
  C --> F[Annotations]
  C --> G[Screenshots and diagnostics]

機能

• 読み取り／書き込みワークフロー向けの、本番環境対応ツールを 17 個提供します。
• サーバーメタデータ、ツール／プロンプト／スキルのリファレンス、コンテキストに応じた要約をまとめたリソースカタログを備えています。
• QA、リリース準備、PM 向けブリーフィング、エンジニアリング計画のワークフロープロンプトを提供します。
• stdio と Streamable HTTP の 2 種類のトランスポートに対応しています。
• API トークンまたはメールアドレス／パスワードによる更新フローで認証できます。

インストール

Node.js 18 以降が必要です。

NPX（推奨）

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_URL": "https://www.vynix.in",
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

npm グローバルインストール

npm install -g @usevynix/mcp-server
vynix-mcp

Docker

docker run --rm -i \
  -e VYNIX_API_URL=https://www.vynix.in \
  -e VYNIX_API_TOKEN=PASTE_YOUR_TOKEN_HERE \
  ghcr.io/usevynix/vynix-mcp:latest

ローカル開発

git clone https://github.com/UseVynix/vynix-mcp.git
cd vynix-mcp
npm install
npm run build
npm run check
node dist/index.js

クライアントの設定

Claude Desktop

claude_desktop_config.json を使用します。

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

診断情報は stderr に書き込まれ、stdout はプロトコルストリーム専用です。

Cursor

~/.cursor/mcp.json を使用します。

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

VS Code

トップレベルに servers を指定した .vscode/mcp.json を使用します。

{
  "servers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Windsurf

Windsurf の MCP 設定ファイルで、次のサーバーブロックを使用します。

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

ChatGPT コネクター

ホストモードでは、Streamable HTTP エンドポイントを使用します。

• ベース URL：https://mcp.vynix.in/mcp
• OAuth ディスカバリー：/.well-known/oauth-authorization-server

一般的な mcp.json

examples/configs/mcp.json を参照してください。

認証

環境変数：

• VYNIX_API_URL（省略可能、デフォルト：https://www.vynix.in）
• VYNIX_API_TOKEN（推奨）
• VYNIX_API_EMAIL と VYNIX_API_PASSWORD（ログインの代替方式）
• VYNIX_MCP_MODE（stdio または http）
• VYNIX_MCP_HOST、VYNIX_MCP_PORT、VYNIX_MCP_PATH（HTTP モード）

トークンは次の場所で生成できます：https://www.vynix.in/mcp

ツール、プロンプト、リソース

• ツールリファレンス：docs/tools.md
• プロンプトリファレンス：docs/prompts.md
• リソースリファレンス：docs/resources.md
• スキル／ワークフローのリファレンス：docs/skills.md
• デプロイガイド：docs/deployment.md
• エージェントの検出ガイド：docs/agent-discovery.md
• LLM インデックスファイル：llms.txt
• ディレクトリ掲載状況のトラッカー：docs/listings-status.md

例

• 会話ワークフロー：examples/workflows
• プロンプトライブラリ（100 件以上のプロンプト）：examples/prompts.md

トラブルシューティング

• Not configured エラー：VYNIX_API_TOKEN、または VYNIX_API_EMAIL と VYNIX_API_PASSWORD の両方を設定してください。
• 401 エラー：トークンを再生成し、API URL を確認してください。
• ツールが表示されない場合：クライアントに応じて、MCP 設定キー（mcpServers または servers）を確認してください。
• ホストモードに接続できない場合：VYNIX_MCP_MODE=http が設定されていることを確認し、/health を確認してください。

FAQ

これはサードパーティの AI プロバイダーにデータを送信しますか？

外部 AI プロバイダーを呼び出せるのは、Vynix ワークスペースの設定を通じて diagnose_annotation を実行する場合のみです。

これは読み取り専用ですか？

いいえ。読み取りツールと書き込みツールが含まれています。MCP アノテーションにより、状態を変更する呼び出しやオープンワールドの呼び出しが識別され、クライアントは確認を求めることができます。

セルフホストできますか？

はい。ローカルで stdio モードを実行するか、独自のインフラストラクチャの背後で HTTP モードを実行します。

コントリビューション

CONTRIBUTING.md をご覧ください。ローカルで検証するには、次を実行します。

npm run check

セキュリティ

• API トークンをコミットしないでください。
• 可能な場合は、有効期間の短いトークンを使用してください。
• SECURITY.md をご覧ください（組織で開示ポリシーが必要な場合は作成してください）。

ライセンス

MIT

変更履歴

CHANGELOG.md