一个MCP服务器,描述图像,转录音频,并总结本地文件中的视频. 它默认情况下会和Google双子座交谈,或者和OpenRouter等任何OpenAI相容的终点交谈.

□ 特性

• 选择您的提供者: Google 双子座( 默认) 或 OpenAI 兼容的终点
• 用于当地图像、音频和视频的三个MCP工具
• 可选双子座模型倒置,加上最终的OpenAI兼容备份
• 通过PARALLEL_PROMPTS进行多视角平行推断(见配置参考)

模型支持因提供者而异. 选取OpenAI相容的提供者,并不意味着每个端点或模型处理每个媒体类型. 而服务器从不单独在不同的模型或供应商中互换.

□ 先决条件

• 节点.js18.0.0或以后
• 给你的供应商的 API 密钥: -双子座:GOOGLE_API_KEY
• OpenAI兼容性:OPENAI_COMPATIBLE_API_KEY

□ 安装

□ 快速启动

将服务器添加到您的 MCP 客户端配置中,并将其指向已建 [[T3] :

在Windows上,在路径中使用前鞭或双回鞭([[T4]). 保存文件并重新连接您的 MCP 客户端 .

MCP Video Recognition Server

An MCP server that describes images, transcribes audio, and summarizes video from local files. It talks to Google Gemini by default, or to any OpenAI-compatible endpoint such as OpenRouter.

Features

• Pick your provider: Google Gemini (default) or an OpenAI-compatible endpoint
• Three MCP tools for local images, audio, and video
• Optional Gemini model fallback, plus a final OpenAI-compatible backup
• Opt-in multi-perspective parallel inference via PARALLEL_PROMPTS (see the Configuration Reference)

Model support varies by provider. Picking the OpenAI-compatible provider does not mean every endpoint or model handles every media type. And the server never swaps in a different model or provider on its own.

Prerequisites

• Node.js 18.0.0 or later
• An API key for your provider:
  • Gemini: GOOGLE_API_KEY
  • OpenAI-compatible: OPENAI_COMPATIBLE_API_KEY

Install

git clone https://github.com/yourusername/mcp-video-recognition.git
cd mcp-video-recognition
npm install
npm run build

Quickstart

Add the server to your MCP client config and point it at the built dist/index.js:

{
  "mcpServers": {
    "video-recognition": {
      "command": "node",
      "args": ["/path/to/mcp-video-recognition/dist/index.js"],
      "env": {
        "GOOGLE_API_KEY": "your_google_api_key"
      }
    }
  }
}

On Windows, use forward slashes or doubled backslashes (\\) in the path. Save the file and reconnect your MCP client. Environment variables must be present in the MCP client’s env configuration; the server process does not automatically inherit values merely because a .env file exists beside it.

For OpenRouter or another OpenAI-compatible endpoint, set RECOGNITION_PROVIDER=openai-compatible and fill in its variables. Configuration has a ready-made example.

Standalone Client

The repository includes a client that builds the project, spawns the server over stdio, performs MCP initialization, and lists the tools. It loads .env from the repository root when that file exists; already-set process environment variables take precedence.