MCP工具示例

KLinePic MCP Server and Agent API Examples

English | 简体中文 | 日本語 | 한국어

Turn broker or exchange fills into annotated candlestick review-chart PNGs. AI agents can discover capabilities, validate a request without spending chart quota, and render the finished chart through three MCP tools.

KLinePic is for post-trade review and visualization. It does not provide trading signals, price predictions, investment advice, or order execution.

Quick start

Requirements:

• Node.js 20 or newer.
• A KLinePic Agent API key. Create one from the account page; the free tier does not require a sales conversation.

Run directly from GitHub:

KLINE_AGENT_API_KEY=kline_agent_xxx \
  npx -y github:sher1096/klinepic-agent-api-examples

Or clone the repository:

git clone https://github.com/sher1096/klinepic-agent-api-examples.git
cd klinepic-agent-api-examples
npm ci
KLINE_AGENT_API_KEY=kline_agent_xxx npm start

Sample data

Run the standalone no-charge example:

KLINE_AGENT_API_KEY=kline_agent_xxx node examples/preflight.mjs

MCP client configuration

Most macOS and Linux clients can run the GitHub package directly:

{
  "mcpServers": {
    "klinepic": {
      "command": "npx",
      "args": [
        "-y",
        "github:sher1096/klinepic-agent-api-examples"
      ],
      "env": {
        "KLINE_AGENT_API_KEY": "kline_agent_xxx"
      }
    }
  }
}

Some Windows clients need cmd.exe to resolve npx.cmd:

{
  "mcpServers": {
    "klinepic": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "github:sher1096/klinepic-agent-api-examples"
      ],
      "env": {
        "KLINE_AGENT_API_KEY": "kline_agent_xxx"
      }
    }
  }
}

Keep the key in the client environment or secret store. Do not commit it.

Troubleshooting

• KLINE_AGENT_API_KEY is required — create a key and pass it through the MCP client's environment.
• HTTP 401 — the key is invalid or revoked.
• HTTP 402 — the account or key quota is exhausted; capabilities shows the relevant limit.
• HTTP 403 — the key lacks the required scope or its IP allowlist blocks the caller.
• HTTP 422 — the request data is invalid; run preflight and inspect the structured details.
• Windows cannot find npx — use the cmd /c npx configuration above.