可视化生成服务

一个基于Google Gemini API的模型上下文协议(MCP)服务器,提供将概念、数据、代码或描述可视化为图像的功能。

  • by sandst1
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 sandst1/mcp-visualize

使用说明

MCP展示台

模型上下文协议(MCP)服务器,使用Google的Gemini API提供可视化生成功能。此服务器允许MCP客户端将任何概念、数据、代码、流程或描述可视化为图像,包括图表、图解、模型、流程图等。

特性

  • 可视化工具: visualize
    • 接受一个提示,描述要可视化的内容(文本、代码、数据、规格、概念)。
    • 返回生成的图像可视化。
  • 运输:服务器发送事件(SSE),便于集成。
  • 模型:用途 gemini-3-pro-image-preview 用于生成高质量的图像。

先决条件

  • Node.js(v18或更高版本)
  • 启用Gemini API的谷歌云项目。
  • 双子星API密钥。

安装

  1. 克隆存储库。

  2. 安装依赖项:

    npm install
    

配置

  1. 创建 .env 根目录中的文件(从以下位置复制 .env.example):

    cp .env.example .env
    
  2. 将Gemini API密钥添加到 .env:

    GEMINI_API_KEY=your_gemini_api_key_here
    PORT=3389
    

用法

发展

在开发模式下运行服务器(自动重新加载):

npm run dev

生产

构建并启动服务器:

npm run build
npm start

码头工人

使用Docker Compose运行服务器:

docker compose up -d

这将构建映像并启动容器。服务器将在以下时间可用 http://localhost:3389.

要在更改后重建映像,请执行以下操作:

docker compose up -d --build

要停止服务器,请执行以下操作:

docker compose down

备注:确保你的 .env 文件包含 GEMINI_API_KEY 在运行Docker Compose之前。

API终点

服务器在配置的端口上侦听(默认: 3389).

  • SSE端点: http://localhost:3389/sse
  • 消息端点: http://localhost:3389/message (处理POST消息)

连接到像Cursor这样的AI工具

  1. 打开光标设置>功能>MCP。
  2. 添加新的MCP服务器:
{
  "mcpServers": {
    "visualize": {
      "url": "http://localhost:3389/sse"
    }
  }
}