AI导哈

经纪API服务器

Freedom24 MCP Server是一个为Freedom24/Tradernet经纪API提供市场数据、投资组合、交易和警报工具的服务。

  • by nonnname
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 nonnname/freedom24mcp

使用说明

Freedom24 MCP服务器

MCP服务器 Freedom24/Tradernet 经纪人API。通过以下方式提供市场数据、投资组合、交易和警报工具 模型上下文协议.

先决条件

设置

git clone https://github.com/nonnname/freedom24mcp.git
cd freedom24mcp
npm install
npm run build

使用Claude Desktop

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "freedom24": {
      "command": "node",
      "args": ["/absolute/path/to/freedom24mcp/dist/index.js"],
      "env": {
        "TRADERNET_PUBLIC_KEY": "your-public-key",
        "TRADERNET_PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

保存后重新启动Claude Desktop。

使用Claude代码

claude mcp add freedom24 node /absolute/path/to/freedom24mcp/dist/index.js \
  -e TRADERNET_PUBLIC_KEY=your-public-key \
  -e TRADERNET_PRIVATE_KEY=your-private-key

环境变量

变量 必填 描述
TRADERNET_PUBLIC_KEY 是 来自Freedom24的API公钥
TRADERNET_PRIVATE_KEY 是 来自Freedom24的API私钥
TRADERNET_HOST 没有 API主机，默认为 freedom24.com
TRADERNET_ALLOW_TRADING 否 默认情况下已禁用。设为 true, 1, yes，或 on 注册交易和编写警报工具

默认情况下，服务器以只读模式运行，不注册写工具。

工具

市场数据（只读）

工具 说明
get_security_info 获取有关证券的详细信息（名称、货币、最小步长）
search_ticker 按名称或股票代码搜索证券
get_candles 获取OHLCV烛台数据（1m、5m、15m、1h、1d）
get_order_book 通过WebSocket获取当前买卖订单簿

投资组合（只读）

工具 说明
get_portfolio 获取当前职位和账户信息
get_orders 获取订单历史和活动订单

交易

启用只读模式时未注册。

工具 说明
place_order 下达买入/卖出订单（市价、限价、止损、止损限价）
cancel_order 取消现有订单
set_stop_loss 在头寸上设置止损和/或止盈

警报

启用只读模式时，写警报工具未注册。

工具 说明
get_alerts 列出当前价格提醒
add_price_alert 创建新的价格预警
delete_price_alert 删除价格提醒

安全

  • 所有API调用都使用HMAC-SHA256签名请求
  • API键是从环境变量中读取的，从不进行硬编码
  • 主机已根据已知Freedom24域的列表进行验证
  • 根据allowlist验证API命令以防止误用
  • 对错误消息进行清理，以避免泄露内部详细信息

api参考

免责声明

这是一个非官方的开源项目，与Freedom Finance/Freedom24无关或不受其支持。它通过Tradernet API与现场经纪账户互动。在金融市场交易涉及损失风险。作者对使用本软件造成的任何经济损失不承担任何责任。使用风险由您自行承担，并始终独立验证数据。

许可证

麻省理工学院 --谢尔盖·日丹诺夫

相关 MCP