# Mcp Server Echart

> 基于 mcp-go 框架构建的 mcp 服务，它提供了一个能动态生成 ECharts 图表页面的工具。

- **Type:** MCP server
- **Install:** `agentstack add mcp-cnkanwei-mcp-server-echart`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cnkanwei](https://agentstack.voostack.com/s/cnkanwei)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cnkanwei](https://github.com/cnkanwei)
- **Source:** https://github.com/cnkanwei/mcp-server-echart

## Install

```sh
agentstack add mcp-cnkanwei-mcp-server-echart
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# mcp-server-echart

[](https://opensource.org/licenses/MIT)

一个基于 `mcp-go` 框架构建的 Go 服务，它提供了一个能动态生成 ECharts 图表页面的工具。

## ✨ 功能特性

- **动态图表生成**：通过调用工具，传入 ECharts 的 JSON 配置，即可生成一个独立的 HTML 图表页面。
- **高度可配置**：支持自定义图表的标题、宽度和高度。
- **现代化页面**：生成的图表页面拥有一个干净、现代化的外观。
- **Docker 支持**：提供 `Dockerfile`，可以轻松构建轻量、可移植的 Docker 镜像。
- **配置灵活**：通过环境变量或 `.env` 文件进行配置，轻松适配不同环境。

---

## 🚀 快速开始

### 1. 准备工作

- [Go](https://golang.org/) (版本 1.24 或更高)
- [Docker](https://www.docker.com/) (可选，用于容器化部署)

### 2. 克隆与配置

克隆本仓库到您的本地：
```bash
git clone https://github.com/cnkanwei/mcp-server-echart.git
cd mcp-server-echart
```

复制配置文件模板，并根据需要进行修改：
```bash
cp .env.example .env
```

`.env` 文件包含以下配置项：

- `PORT`: 服务监听的端口 (默认: `8989`)
- `PUBLIC_URL`: 对外暴露的 URL 根路径 (例如 `http://localhost:8989` 或 `https://your.domain.com`)
- `LOG_LEVEL`: 日志级别 (例如 `info`, `debug`)
- `STATIC_DIR`: 生成的静态 HTML 文件存放的目录 (默认: `static`)

### 3. 安装依赖

```bash
go mod tidy
```

---

## 📦 如何运行

### 在本地运行

```bash
go run main.go
```

服务启动后，会监听在 `.env` 文件中配置的 `PORT` 端口（默认为 8989）。

### 使用 Docker 运行

1.  **构建 Docker 镜像:**
    ```bash
    docker build -t mcp-server-echart .
    ```

2.  **运行 Docker 容器:**
    ```bash
    # 基础运行
    docker run -p 8989:8989 -d --name my-echart-server mcp-server-echart

    # 自定义端口和对外 URL
    docker run -p 9090:9090 \
      -e PORT=9090 \
      -e PUBLIC_URL="https://my.domain.com" \
      -d --name my-echart-server mcp-server-echart
    ```

---

## 🛠️ 工具 (Tool) API

本服务提供了一个名为 `generate_echarts_page` 的工具。

### 参数

- `title` (string, **必需**): 图表页面的标题。
- `inputSchema` (object, **必需**): ECharts 的 JSON 配置对象。
- `width` (number, *可选*): 图表的宽度（像素），默认 800。
- `height` (number, *可选*): 图表的高度（像素），默认 600。

### 返回值

成功调用后，工具会返回一个 URL，指向新生成的图表页面。

---

## 💻 如何使用

本服务可以通过任何支持 Server-Sent Events (SSE) 的 MCP 客户端进行调用。

### 客户端配置

如果您使用的 MCP 客户端支持通过配置文件连接到服务器，您可以添加如下配置来连接到本服务。

请将 `mcp-server-echart` 添加到您的客户端配置中，并将 URL 指向本服务的监听地址（默认为 `http://localhost:8989/sse`）。

**示例配置 (`client-config.json`):**
```json
{
  "mcpServers": {
    "mcp-server-echart": {
      "url": "http://localhost:8989/sse"
    }
  }
}
```

**另一个示例 (例如，用于浏览器环境):**
```json
{
  "mcpServers": {
    "browser-use-mcp-server": {
      "url": "http://localhost:8000/sse"
    }
  }
}
```

> **注意**:
> - URL 应与您在 `.env` 文件中配置的 `PORT` 和 `PUBLIC_URL` 保持一致。
> - `mcp-go` 工具调用的默认端点是 `/sse`，而不是 `/`。

### 客户端配置 (通过 Docker 命令)

如果您的 MCP 客户端支持通过命令启动服务，您也可以配置它来直接运行 Docker Hub 上的镜像。这会将服务作为一个子进程来管理，客户端通过标准输入/输出 (stdin/stdout) 与其通信。

这对于本地开发或将服务分发给他人使用非常方便。

**示例配置 (`client-config.json`):**
```json
{
  "mcpServers": {
    "mcp-server-echart-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p",
        "8989:8989",
        "-e",
        "PORT=8989",
        "-e",
        "PUBLIC_URL=http://localhost:8989",
        "cnkanwei/mcp-server-echart:latest"
      ]
    }
  }
}
```
> **注意**:
> - `-p 8989:8989` 将容器的 8989 端口映射到主机的 8989 端口，以便您可以从浏览器访问生成的图表。
> - `cnkanwei/mcp-server-echart:latest` 是发布在 Docker Hub 上的公共镜像。

---

## 📜 许可证

本项目基于 [MIT License](LICENSE) 开源。

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cnkanwei](https://github.com/cnkanwei)
- **Source:** [cnkanwei/mcp-server-echart](https://github.com/cnkanwei/mcp-server-echart)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-cnkanwei-mcp-server-echart
- Seller: https://agentstack.voostack.com/s/cnkanwei
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.