You run a Model Context Protocol (MCP) server that exposes chart tools to interact with Quick Chart through a standardized interface. This server helps AI agents open and work with Quick Chart pages more smoothly by providing well-defined commands and endpoints.

How to use

You interact with the Quick Chart MCP server through an MCP client. Use the available tools to retrieve chart images or install the Quick Chart service locally, enabling AI agents to request chart visuals and integrate them into workflows.

How to install

Prerequisites: ensure you have Node.js version 16 or higher installed on your machine.

Option 1: Installing via Smithery (recommended for Claude Desktop users) • Run this command to install automatically:

npx -y @smithery/cli install @datafe/quick-chart-mcp --client claude

Option 1: Install from npm (recommended for clients like Cursor/Cline)

Install the MCP server globally so you can run it from anywhere.

# Install globally
npm install -g quick-chart-mcp

# Or install locally in your project
npm install quick-chart-mcp

Option 2: Build from source (for developers)

If you prefer building from source, follow these steps to clone, install dependencies, and run the development server.

git clone https://github.com/datafe/quick-chart-mcp
cd quick-chart-mcp
pnpm install

pnpm run build

pnpm run dev

Open http://localhost:5173 to access the development server.

## MCP Configs

The MCP configuration defines how your server is exposed to MCP clients. Use the following JSON configuration to register the Quick Chart MCP server.

{ "mcpServers": { "quick-chart-mcp": { "autoApprove": [], "disabled": false, "timeout": 300, "command": "npx", "args": [ "quick-chart-mcp@1.0.13" ], "transportType": "stdio" } } }

## Environment setup

Create a .env file to configure runtime behavior and optional Quick Chart settings.

Quick Chart Configuration

NODE_ENV=optional_development_or_product QUICK_CHART_DRAW_URL=optional_quick_chart_draw_url NEED_INSTALL_QUICK_CHART=optional_true_or_false

## Project structure

The project layout includes a source entry point and standard configuration files.

quick-chart-mcp/ ├── src/ │ ├── index.ts # Main entry point ├── package.json └── tsconfig.json

## Security considerations

Use environment variables for sensitive information and regularly monitor AI agent activities to safeguard interactions with Quick Chart.

## Troubleshooting

If you run into issues, verify that the build completed successfully and that the MCP server is reachable by the client.

## Dependencies

The server relies on image APIs and Node.js tooling. Ensure your environment provides the necessary dependencies for running a JavaScript/TypeScript project with MCP support.

## Contributing

Contributions are welcome. Follow standard practices for forking, branching, and creating pull requests to propose enhancements.

## License

This project is licensed under the MIT License.

## Available tools

### GetChartImgLink

Retrieve a chart image link by providing chart parameters to the MCP server.

### InstallQuickChart

Install the Quick Chart service locally so you can generate charts from the MCP client.