Vynix

in.vynix由 vynix.in 发布官方发布者v0.1.4更新于 Oct 27, 2026

Give AI coding agents access to your Vynix visual feedback, bug reports, and AI diagnosis.

已验证Streamable HTTP可网页运行效率与工作流开发者工具AI 与机器学习

概览

AI 生成的概览

Vynix MCP 让编码助手访问 Vynix 的视觉反馈、缺陷报告、截图、诊断信息以及 GitHub 议题工作流。

可以做什么
  • 列出项目、标注、成员与活动记录，并读取单条标注所捕获的页面、目标元素、DOM 与运行时诊断
  • 查看标注附带的区域截图与评论讨论串
  • 读取已存储的 AI 诊断，或运行 AI 诊断引擎获取排序后的根因、置信度、修复建议与可能的源文件
  • 为指定助手生成可直接粘贴的编码提示词
  • 从标注创建 GitHub 议题，并按标注或项目列出跟踪议题
  • 更新标注状态、添加评论，并生成只读的公开评审链接
适用场景
适合团队在 Vynix 中收集视觉缺陷与反馈，并希望编码助手基于真实捕获的上下文而非猜测来工作。适用于分诊、诊断、提示词生成以及向 GitHub 议题交接。
运行要求
需要 Vynix 账号，并在 VYNIX_API_TOKEN 中提供个人访问令牌（文档也提到邮箱/密码回退方式）。可作为远程 Streamable HTTP 端点使用，或通过 npx 在本地运行，需 Node.js 18+；VYNIX_API_URL 可选，默认指向 Vynix 站点。需要访问 Vynix API 的网络，议题相关工具经 Vynix 后端访问 GitHub。
安装前请注意
并非只读：工具会更改标注状态、发布会通知团队的评论、创建 GitHub 议题并生成公开分享链接。diagnose_annotation 会调用外部 AI 提供商，消耗 token 并可能产生费用。API 令牌属于凭据，不应提交到代码库，建议使用短期令牌。据 README，仅诊断功能会向第三方 AI 提供商发送数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Vynix，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/in.vynix%2Fvynix-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "vynix": {
      "type": "http",
      "url": "https://mcp.vynix.in/mcp"
    }
  }
}

README

Vynix MCP Server

[npm version] [npm downloads] [license] [ci] [vynix-mcp MCP server]

Model Context Protocol server for Vynix. It gives coding agents direct access to visual feedback, bug reports, screenshots, diagnostics, comments, and issue workflows so agents can reason from real context instead of guessing.

Why Vynix

  • Feedback with evidence: page metadata, target element, screenshot, console/network context.
  • End-to-end execution: inspect feedback, diagnose, generate coding prompts, create GitHub issues, update status, comment.
  • Agent-safe hints: read-only/idempotent/open-world annotations for better approval behavior in MCP clients.
  • Registry-ready metadata for modern MCP directories.

Architecture

mermaid
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]

Features

  • 17 production tools for read and write workflows.
  • Resource catalog for server metadata, tool/prompt/skill references, and contextual summaries.
  • Workflow prompts for QA, release readiness, PM briefings, and engineering planning.
  • Dual transport support: stdio and Streamable HTTP.
  • Auth via API token or email/password refresh flow.

Installation

Node.js 18+ is required.

NPX (recommended)

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

bash
npm install -g @usevynix/mcp-servervynix-mcp

Docker

bash
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

Local development

bash
git clone https://github.com/UseVynix/vynix-mcp.gitcd vynix-mcpnpm installnpm run buildnpm run checknode dist/index.js

Client Configuration

Claude Desktop

Use claude_desktop_config.json:

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

Diagnostics are written to stderr; stdout is reserved for the protocol stream.

Cursor

Use ~/.cursor/mcp.json.

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

VS Code

Use .vscode/mcp.json with top-level servers:

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

Windsurf

Use your Windsurf MCP config file with this server block:

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

ChatGPT connectors

For hosted mode, use the Streamable HTTP endpoint:

  • Base URL: https://mcp.vynix.in/mcp
  • OAuth discovery: /.well-known/oauth-authorization-server

Generic mcp.json

See examples/configs/mcp.json.

Authentication

Environment variables:

  • VYNIX_API_URL (optional, default: https://www.vynix.in)
  • VYNIX_API_TOKEN (recommended)
  • VYNIX_API_EMAIL and VYNIX_API_PASSWORD (fallback login mode)
  • VYNIX_MCP_MODE (stdio or http)
  • VYNIX_MCP_HOST, VYNIX_MCP_PORT, VYNIX_MCP_PATH (HTTP mode)

Generate a token from: https://www.vynix.in/mcp

Tools, Prompts, and Resources

Examples

Troubleshooting

  • Not configured error: set VYNIX_API_TOKEN or both VYNIX_API_EMAIL and VYNIX_API_PASSWORD.
  • 401 errors: regenerate token and verify API URL.
  • No tools listed: confirm the MCP config key (mcpServers vs servers) for your client.
  • Hosted mode not reachable: verify VYNIX_MCP_MODE=http and check /health.

FAQ

Does this send data to third-party AI providers?

Only diagnose_annotation can invoke external AI providers through your Vynix workspace configuration.

Is this read-only?

No. It includes read tools and write tools. MCP annotations identify mutating/open-world calls so clients can request confirmation.

Can I self-host?

Yes. Run in stdio mode locally or HTTP mode behind your own infrastructure.

Contributing

See CONTRIBUTING.md. For local validation run:

bash
npm run check

Security

  • Never commit API tokens.
  • Prefer short-lived tokens where possible.
  • See SECURITY.md (create one if your org requires a disclosure policy).

License

MIT

Changelog

CHANGELOG.md

来源：README.md，提交 d60e3db

工具

17

list_projects

List projects

List the Vynix projects you own.

无需输入参数。

list_annotations

List annotations

List a project’s annotations, optionally filtered by status, type, or priority. Start here with status "open" to see what needs fixing.

输入参数typelimitoffsetstatuspriorityproject_id必填

get_annotation

Get annotation

Fetch one annotation with its full captured context: page, target element (selector, XPath, styles), surrounding DOM, and runtime diagnostics (console + network).

输入参数annotation_id必填

list_comments

List comments

Read the discussion thread on an annotation.

输入参数annotation_id必填

get_annotation_analysis

Get AI diagnosis

Read the latest stored AI diagnosis for an annotation (root causes, confidence, suggested fix, and likely source files). Returns null when none has been generated yet; run diagnose_annotation to create one.

输入参数annotation_id必填

get_annotation_screenshots

Get screenshots

Return the region screenshots attached to an annotation as viewable images, so you can see exactly what the reporter pointed at.

输入参数annotation_id必填

list_annotation_issues

List annotation issues

List the tracker (GitHub) issues opened from an annotation, with each issue’s live state. Set refresh to reconcile against GitHub (open/closed + any linked pull request).

输入参数refreshannotation_id必填

list_project_issues

List project issues

List every tracker issue across a project, with an open/closed/agent summary.

输入参数project_id必填

generate_prompt

Generate coding prompt

Render a ready-to-paste coding prompt for an annotation, formatted for a target assistant. A deterministic template (no AI spend); for a deeper analysis use diagnose_annotation.

输入参数targetannotation_id必填

get_metrics

Get metrics

Overview of your projects: KPI counts, status breakdown, a daily time series, and recent activity.

无需输入参数。

list_members

List members

List a project’s team members, including role and status.

输入参数project_id必填

get_activity

Get activity

Recent activity feed for a project (status changes, comments, issues, members).

输入参数project_id必填

update_annotation_status

Update status

Update an annotation’s status, e.g. to mark it in_progress or completed.

输入参数status必填annotation_id必填

add_comment

Add comment

Add a comment to an annotation’s thread, e.g. to record what you changed. Notifies the team.

输入参数body必填annotation_id必填

diagnose_annotation

Run AI diagnosis

Run the AI Diagnosis Engine on an annotation: it analyses the captured page, element, DOM, and runtime errors to produce ranked root causes, a confidence score, a suggested fix, and the likely source files. Calls an AI provider (uses tokens / may cost money) and stores the result. Requires AI + diagnosis enabled by the workspace admin and a key set.

输入参数modelproviderannotation_id必填

create_github_issue

Create GitHub issue

Create a GitHub issue from an annotation. Uses the project’s configured repo and assignee unless overridden. Embeds the generated AI prompt in the issue body.

输入参数repoassigneesannotation_id必填

版本历史

1
  1. v0.1.4最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分