Gmo Kline MCP

GMO KLine MCP 服务器

我们提供GMO Coin外汇FX的K线（蜡烛图）数据获取API，作为Model Context Protocol（MCP）服务器。通过Claude Desktop、Cursor等MCP客户端，即可轻松获取汇率的历史数据。

📋 目录

• 特点
• 快速启动npx
• 安装
• 使用方法
• 适用环境
• 文件
• 贡献
• 许可证

✨ 特点

该MCP服务器封装了GMO Coin的外汇FX公共API，使其能够通过AI助手轻松使用。

主要功能：

• 无需认证由于是公开API，因此无需API密钥或秘密密钥
• 支持多股票支持USD_JPY、EUR_JPY、GBP_JPY、AUD_JPY、NZD_JPY、CAD_JPY、CHF_JPY、EUR_USD、GBP_USD、AUD_USD等10种货币对
• 支持多时间轴支持从1分钟线到月线在内的12种时间轴（1分钟、5分钟、10分钟、15分钟、30分钟、1小时、4小时、8小时、12小时、1天、1周、1个月）
• 买/卖选择可同时获取买价（BID）和卖价（ASK）
• 历史数据按日期获取过去的K线数据
• 参数验证通过适当的错误信息进行输入验证
• 跨平台可在Windows、macOS、Linux上运行

⚡ 快速启动(npx)

无需本地克隆，可直接通过npx运行。

• 获取工具列表（bash/zsh）

- echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx -y gmo-kline-mcp

• 获取工具列表（PowerShell）

- $j='{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'; $j | & npx -y gmo-kline-mcp

Claude Desktop 注册（推荐）

• command： npx
• args： ["-y", "gmo-kline-mcp"]

如需使用现有步骤（克隆后使用），请参阅下面的“安装”。

🚀 安装

前提条件

• Node.js 18.0.0及以上版本
• pnpm、npm 或 yarn

步骤

# リポジトリのクローン
git clone https://github.com/Mako3333/gmo-kline-mcp.git
cd gmo-kline-mcp

# 依存パッケージのインストール
pnpm install
# または
npm install

📖 使用方法

注册MCP客户端

推荐：使用npx进行注册（适用于macOS/Linux/Windows）

{
  "mcpServers": {
    "gmo-kline": {
      "command": "npx",
      "args": ["-y", "gmo-kline-mcp"]
    }
  }
}

Claude Desktop（中文可译为“Claude桌面版”或保持原名，根据上下文决定是否需要具体翻译）

设置文件（claude_desktop_config.json)在其中添加以下内容：

macOS/Linux：

{
  "mcpServers": {
    "gmo-kline": {
      "command": "node",
      "args": ["/absolute/path/to/gmo-kline-mcp/index.js"]
    }
  }
}

Windows：

{
  "mcpServers": {
    "gmo-kline": {
      "command": "node",
      "args": ["C:/path/to/gmo-kline-mcp/index.js"]
    }
  }
}

光标

项目路线.cursor/mcp.json并添加以下内容：

{
  "mcpServers": {
    "gmo-kline": {
      "command": "node",
      "args": ["/absolute/path/to/gmo-kline-mcp/index.js"]
    }
  }
}

使用示例

向AI助手发送以下提示后，会自动get_klines工具会被调用。

示例1：获取日线数据

USD/JPYの2025年の日足ASK価格データを取得して、最高値と最安値を教えてください。

示例2：获取1分钟足数据

2025年10月17日のEUR/JPYの1分足BID価格データを取得してください。

示例3：多只股票的比较

USD/JPYとEUR/JPYの2024年の日足データを取得して、どちらがより変動が大きかったか比較してください。

从命令行直接执行

# ツール一覧の確認
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node index.js

# KLineデータの取得
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_klines","arguments":{"symbol":"USD_JPY","priceType":"ASK","interval":"1day","date":"2024"}}}' | node index.js 2>/dev/null

使用npx直接执行

• bash/zsh（注：这通常指的是Unix/Linux操作系统中的两种shell，bash为Bourne-Again Shell，zsh为Z Shell）

- echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | npx -y gmo-kline-mcp

• PowerShell：

- "$j='{""jsonrpc"": ""2.0"", ""id"": 1, ""method"": ""tools/list"", ""params"": {}}'; $j | & npx -y gmo-kline-mcp"

PowerShell注意事项：执行管道末端时需使用调用运算符 & 请加上。

🛠️ 工具规格

获取K线数据

获取GMO Coin外汇FX的K线（蜡烛图）数据。

参数

日期指定规则（重要）

• 1分钟，5分钟，10分钟，15分钟，30分钟，1小时 YYYYMMDD 例： 20241028
• 4小时，8小时，12小时，1天，1周，1个月 YYYY 例： 2024
• 两种格式均可接受，但服务器端会根据间隔时间进行一致性检查，如不一致则返回错误。

响应

返回K线数据的数组。每个数据包含以下字段。

• openTime开始时刻的Unix时间戳（毫秒）
• open开盘价
• high高价
• low低价
• close收盘价

💻 支持环境

此MCP服务器已在以下环境中进行过测试。

• 操作系统（Operating System，简称OS）Windows 11，macOS 14，Ubuntu 22.04
• Node.jsv18.x，v20.x，v22.x
• MCP客户端克劳德桌面，光标

📚 文档

请参阅以下文件以获取详细文档。

• SETUP.md 翻译为中文是：“设置指南/安装说明.md” - 安装与设置的详细步骤
• USAGE_EXAMPLES.md 翻译为中文是：“使用示例.md” - 实用的使用案例与最佳实践
• TEST_RESULTS.md 翻译为中文是：“测试结果.md”（其中“.md”通常表示Markdown格式的文件） - 测试结果报告
• CONTRIBUTING.md 翻译为中文是：“贡献指南/贡献说明文件”。这个文件通常用于说明如何为某个项目或组织做出贡献，包括贡献的流程、规范、期望等 - 贡献指南
• CHANGELOG.md（变更日志文件） - 更改历史

🤝 贡献

我们欢迎您的贡献！无论是报告漏洞、提出功能需求，还是提交拉取请求，任何形式都行。

详情如下CONTRIBUTING.md 翻译为中文是：“贡献指南/贡献规范文件”。这个文件通常用于说明如何向项目做出贡献，包括提交代码、报告问题、参与讨论等方面的指南请参考。

贡献者

感谢所有为这个项目做出贡献的人。

📄 许可证

此项目在MIT许可协议下授权。详情请参阅许可证请参考文件。

🔗 相关链接

• GMO币外汇FX API文档
• 模型上下文协议规范
• MCP SDK（MCP软件开发工具包）

⚠️ 免责声明

此项目与GMO Coin株式会社无关。它是使用公开的公共API的非官方工具。

使用时请自行负责。交易判断及投资决策前，请务必咨询专家。

📞 支持

如出现问题问题然后请汇报。

______________________________________________________________________

由社区用心打造