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

Vynix MCP 服务

Vynix 的模型上下文协议服务。它让编码 Agent 能够直接访问视觉反馈、错误报告、屏幕截图、诊断信息、评论和问题工作流，使 Agent 能依据真实上下文进行判断，而不是凭空猜测。

为什么选择 Vynix

• 有据可依的反馈：页面元数据、目标元素、屏幕截图、控制台和网络上下文。
• 端到端执行：检查反馈、诊断问题、生成编码提示词、创建 GitHub 问题、更新状态、发表评论。
• Agent 安全提示：提供只读／幂等／开放世界注解，帮助 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。
• 支持通过 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
• Agent 发现指南：docs/agent-discovery.md
• 大模型索引文件：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。

常见问题

是否会向第三方 AI 服务商发送数据？

只有 diagnose_annotation 会通过 Vynix 工作区配置调用外部 AI 服务商。

这是只读的吗？

不是。它包含读取工具和写入工具。MCP 注释会标识会修改数据或影响开放世界的调用，以便客户端请求确认。

可以自托管吗？

可以。在本地以 stdio 模式运行，或在自己的基础设施后面以 HTTP 模式运行。

贡献

请参阅 CONTRIBUTING.md。要在本地进行验证，请运行：

npm run check

安全

• 切勿提交 API 令牌。
• 尽可能优先使用短期令牌。
• 请参阅 SECURITY.md（如果你的组织要求制定披露政策，请创建该文件）。

许可证

MIT

更新日志

CHANGELOG.md