Stockbit MCP

Stockbit MCP

为 Claude、ChatGPT 和其他 MCP 客户端提供 Stockbit 市场数据、分析、图表绘制、只读券商投资组合及模拟交易。 非官方产品，与 Stockbit 或 IDX 无关联。

此版本无法执行真实资金交易。 已移除真实买入、卖出、修改、取消和 e-IPO 申购工具及其 HTTP 路由。不支持存款和取款。旧版 live 设置会安全关闭；没有可恢复真实交易执行的开关。这是技术限制，并非声称获得 OJK 批准或法律合规认证。

Bahasa Indonesia · 工具参考 · 客户端设置 · 安全 · 验证

构建并登录

请使用此代码库副本或已验证的 1.4.1 或更高版本发布制品。1.3.1 npm 包不包含这些更改；较早的 v1.4.0 GitHub 标签也指向 1.3.1 包清单。

npm ci
npm run build
node dist/bin/stockbit-auth.js login
node dist/bin/stockbit-auth.js status

需要 Node.js 22+ 和基于 Chromium 的浏览器，用于登录和交互式图表绘制。请在 Stockbit 自有页面上登录；助手绝不会索取密码和 OTP。凭据会保存在操作系统钥匙串中，或作为备用方案保存在加密文件中。浏览器会话和 API 会话彼此独立；status 会说明哪一个需要处理。

连接客户端

Claude Desktop 的 claude_desktop_config.json 可以启动已构建的服务：

{
  "mcpServers": {
    "stockbit": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/stockbit-mcp/dist/bin/stockbit-mcp.js"],
      "env": {
        "STOCKBIT_MCP_TRANSPORT": "stdio",
        "STOCKBIT_TOOLS": "core,chartbit,virtual"
      }
    }
  }
}

使用 command -v node（PowerShell：(Get-Command node).Source）查找 Node 的路径，并替换两个示例路径。更改配置后重启客户端。STOCKBIT_TOOLS=all 会启用完整的受支持工具集；core 是规模较小的默认选项。配置文件用于选择功能，而非授予转移真实资金的权限。

你也可以使用 npm run build:mcpb 构建本地 Claude Desktop 扩展。请参阅客户端设置，了解安装和配置文件选择。

对于 ChatGPT，请使用其支持的 Secure MCP Tunnel，或妥善保护的远程 MCP 部署。将本地文件路径粘贴到连接器中，并不会让 ChatGPT 能够访问 stdio 服务。 客户端设置介绍了当前要求、可选的本地 HTTP 传输方式，以及仍需完成的部署步骤。

功能

任务	工具 / 系列
报价、订单簿、涨跌幅榜、交易时段、逐笔成交	market
券商累积、分布、资金流	bandarmology
指标、形态、策略比较、回测、扫描	analysis
基本面、所有权、内部人士、公司行动、IPO 信息	fundamentals、company、insider、corpaction、eipo
新闻、Stockbit 帖子和研究内容	stream
自选列表和已保存的筛选器，包括编辑	account、screener
读取、绘制、检查、截图并保存 Stockbit 图表	chartbit
真实投资组合、持仓、现金和订单历史记录——仅供读取	portfolio、position、cash_balance、orders、order_history
Stockbit 网站的模拟账户	virtual_*
独立的本地模拟账本	paper_*
本地提醒、Pine 脚本和已保存的只读工作流	alerts、pine、workflows

这是受支持的 API 范围，并不意味着 Stockbit 网站上的每项功能都有对应工具。功能权限、上游未公开的更改、登录状态和浏览器可用性都可能限制个别工具。证据标签用于区分实际观察到的响应与推断映射；无法识别的账户数值会保持缺失，而不会转换为零。

投资组合与模拟是分开的

读取真实证券账户需要证券会话。请在终端上自行解锁：

node dist/bin/stockbit-auth.js trading-login

PIN 在本地输入，不会存储或传递给 MCP 工具。解锁会话不会启用交易：此版本没有真实订单提交路径。

virtual_* 使用 Stockbit 网站的虚拟账户，通过普通 Stockbit 登录。它与真实投资组合和本地模拟账本相互独立。只有 /virtualtrading/ 下的路由可以提交这些模拟订单。依赖结果前，请先阅读每个工具的验证注意事项。

对于独立的本地模拟账本：

node dist/bin/stockbit-auth.js trading-enable --paper

使用 paper_order_preview，检查委托单，然后调用对应的 paper_order_buy、paper_order_sell、paper_order_amend 或 paper_order_cancel。检查 paper_portfolio 和 paper_orders，查看模拟结果。portfolio 始终读取真实证券账户的投资组合，即使启用了本地模拟模式也是如此。

图表绘制

启用 chartbit 系列工具，并使用已保存的浏览器配置文件登录。典型流程为 chartbit_open → chartbit_shapes → chartbit_draw → chartbit_screenshot → chartbit_save。 从 chartbit_layouts 获取对应的布局 ID，并将其传递给 chartbit_save，以执行范围限定的持久性检查。布局元数据不足时，保存结果会将验证状态报告为未知。 先读取现有绘图。仅清除由服务端创建且 scope: "ours" 的形状；删除所有形状或替换已保存的布局都需要明确确认。保存路径会针对 Stockbit 已存储的布局/绘图验证持久性。

请求示例：“分析 BBRI 并绘制其支撑位和阻力位”、“显示我的投资组合”、“比较 BBRI 和 TLKM 的券商资金流”或“显示我的 Stockbit 虚拟订单”。

验证

npm run typecheck
npm test
npm run build
npm run docs:tools
npm run smoke
npm run check:pack

登录后，运行可复用的只读 MCP 检查：

npm run verify:tools -- --live

它会盘点每个已注册工具，并记录通过的读取操作、上游故障、缺失的前置条件，以及需要在受控场景中执行的变更操作/浏览器操作。它不会下单、编辑账户状态或打开浏览器。报告存储在被忽略的 .stockbit/ 目录下，且不包含响应内容。--only quote,analyze 可缩小后续检查范围。隔离的测试套件涵盖变更防护和模拟写入场景，不会触及账户。

该 API 为私有 API，且可能发生变化。本项目不提供投资建议，也不保证自动化访问符合 Stockbit 的条款。请参阅安全边界和验证记录，了解实际限制。