使用说明内容（Markdown格式）

项目简介

本仓库实现了一个基于 MCP 的图表生成后端，提供多种图表类型的生成工具，支持 AI 自动配色、主题系统以及高质量图像输出，供 MCP 客户端通过标准化的 JSON-RPC 方式进行调用。

主要功能点

• 提供15种图表生成工具（如线图、柱状图、面积图、饼图、雷达图、网络图、词云等），每个工具返回可访问的图像链接。
• AI智能配色与主题系统，支持多种调色板与自动映射，提升图表美观度。
• 统一输出格式，返回包含 image_url、success 与 message 的 JSON 响应。
• 支持通过 MCP 协议的工具注册与调用，便于与 LLM 客户端整合。
• 提供静态图片服务器，外部可以通过 http 访问生成的 PNG 图像。

安装步骤

• 1. 获取代码
  • 克隆仓库并进入项目目录。
• 2. 安装依赖并部署
  • 运行命令：pip install -e .
  • 另外确保依赖包含 fastmcp、plotly、pandas、kaleido、wordcloud、matplotlib 等。
• 3. 运行服务器
  • 运行命令：python src/main_optimized.py
  • 服务器将启动 MCP 服务，默认 MCP 端口为 8080，图像静态服务器端口为 8081。

服务器配置

MCP 客户端需要的启动配置（JSON 格式）示例信息如下，描述仅用于参考，实际使用时请按下列字段准备相应配置项： { "server_name": "chart-generator", "command": "python", "args": ["src/main_optimized.py"], "host": "127.0.0.1", "port": 8080, "transport": "streamable-http", "description": "Chart generator MCP server：提供多种图表生成工具及智能配色输出", "notes": "该配置用于客户端连接与启动 MCP 服务器，客户端不需要包含服务端代码，仅使用配置参数与服务器地址建立连接" }

说明：以上配置包含 server name、command、args 等字段，便于 MCP 客户端读取并启动与服务器建立连接；实际客户端使用时只需要该信息来连接并调用服务端提供的工具。

基本使用方法

• 启动后，MCP 客户端通过标准化接口向服务器请求调用工具，如调用某种图表生成工具，并传入数据、字段名等参数。
• 服务端返回包含 image_url 的结果，客户端可通过该 URL 访问生成的图像。
• 如需验证或调试，可在浏览器中打开 http://127.0.0.1:8081/ 查看静态图片服务器上的图片（PNG），确保图片可访问。