Svg MCP Server

SVG MCP服务器

一个符合RFC 7996的SVG图表服务器，使用模型上下文协议（MCP）构建，用于创建技术图表、流程图和网络拓扑可视化。

特性

• 符合RFC 7996：完全支持RFC文档中的SVG要求
• 模型上下文协议：用于AI助手工作流的原生MCP集成
• 综合图表类型：支持流程图、网络图、架构图等
• 生产就绪：Docker容器化，多阶段构建和安全强化
• 版本管理：使用自动化Docker构建进行语义版本控制
• 交叉平台的：支持Windows、macOS和Linux开发环境

快速开始

使用Docker（推荐）

# Pull and run the latest version
docker run -p 3000:3000 svg-mcp-server:latest

# Or build from source
./scripts/build-docker.sh
docker run -p 3000:3000 svg-mcp-server:1.0.0

来源

# Clone the repository
git clone https://github.com/P47Phoenix/svg-mcp-server.git
cd svg-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Start the server
npm start

GitHub Copilot的MCP配置

要将此服务器与GitHub Copilot或其他MCP兼容的AI助手一起使用，请添加以下配置：

选项1：直接使用Node.js

{
  "mcpServers": {
    "svg-mcp-server": {
      "command": "node",
      "args": ["path/to/svg-mcp-server/dist/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

选项2：使用Docker

{
  "mcpServers": {
    "svg-mcp-server": {
      "command": "docker",
      "args": [
        "run", 
        "--rm", 
        "-i", 
        "--network=host",
        "svg-mcp-server:1.0.0"
      ]
    }
  }
}

选项3：使用npx（如果发布到npm）

{
  "mcpServers": {
    "svg-mcp-server": {
      "command": "npx",
      "args": ["svg-mcp-server"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

将此配置放入MCP客户端的配置文件中（通常 mcp-config.json 或类似）。

版本管理

该项目使用语义版本控制和自动化Docker构建：

# Check current version
./scripts/version.sh get

# Bump version and build Docker image
./scripts/version.sh bump patch
./scripts/version.sh docker

# Create a release
./scripts/version.sh release

有关详细的版本管理文档，请参阅 版本_管理.md.

文档

• api参考 -完整的API文件
• MCP集成指南 -详细的MCP客户端配置
• 配置指南 -服务器配置选项
• -Docker部署和配置
• 版本管理 -版本控制和发布工作流程
• 开发指南 -开发设置和指南

建筑

SVG MCP服务器由以下组件构建：

• TypeScript：具有现代ES功能的类型安全开发
• FastMCP SDK：高性能模型上下文协议实现
• Alpine Linux：最小、安全的Docker基础映像
• GitHub操作：具有安全扫描功能的自动化CI/CD管道

贡献

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/amazing-feature
3. 进行更改并彻底测试
4. 调整版本： ./scripts/version.sh bump patch
5. 提交您的更改： git commit -m 'Add amazing feature'
6. 推到分支： git push origin feature/amazing-feature
7. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

• 📚 文档
• 🐛 问题追踪
• 💬 讨论
• 🔧 MCP配置指南 -详细的集成说明

使用示例

一旦配置了MCP客户端，您就可以使用自然语言创建SVG图：

"Create a flowchart showing the user authentication process"
"Generate a network topology diagram with 3 servers and 2 routers"
"Design an architectural diagram for a microservices system"

服务器提供以下工具：

• 基于模板的SVG生成：常见图表类型的预构建模板
• 动态SVG创建：基于规格的自定义图表
• RFC 7996合规性：用于技术文档的符合标准的SVG输出
• 变量替换：可重用图表的参数化模板

版本历史记录

当前版本： 1.0.0

看 更改日志.md 查看详细的版本历史和发行说明。