Quick Chart MCP

🚀 Quick Chart MCP Server

A server implementing the Model Context Protocol (MCP), offering charting tools that enable interaction with Quick Chart through a standardized interface. This implementation is based on chart definitions, allowing users to seamlessly open Quick Chart pages.

🚀 Quick Start

This MCP server tool interacts with Quick Chart and implements the Model Context Protocol specification to standardize chart interactions for AI agents.

✨ Features

• Interact with Quick Chart
• Standardize chart interactions for AI agents

📦 Installation

Prerequisites

• Node.js (v16 or higher)
• pnpm (recommended), npm, or yarn

Installation Methods

Install via Smithery

To automatically install quick-chart-mcp for Claude Desktop, use Smithery:

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

Option 1: Install via npm (Recommended for clients like Cursor/Cline)

# 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)

1. Clone this repository:

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

2. Install dependencies (pnpm is recommended, npm is also supported):

pnpm install

3. Build the project:

pnpm run build

4. Develop the project (Developed by @modelcontextprotocol/inspector):

pnpm run dev

Open http://localhost:5173

📚 Documentation

Configuration

MCP Configuration

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

Environment Configuration

Create a .env file to include your credentials:

# 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

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

Available Tools

This MCP server provides the following Quick Chart tools:

• GetChartImgLink - Get the chart image link via parameters.
• InstallQuickChart - Install the quick chart service locally.

Security Considerations

• Store sensitive information using environment variables.
• Regularly monitor and audit AI agent activities.

Troubleshooting

If you encounter issues:

1. Verify that the build was successful.

Dependencies

Image API.

Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork and clone the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is distributed under the MIT License.

Badge