Freedom24 MCP服务器
MCP服务器 Freedom24/Tradernet 经纪人API。通过以下方式提供市场数据、投资组合、交易和警报工具 模型上下文协议.
先决条件
- Node.js 22+
- Freedom24 API密钥(设置→ 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_READONLY | 否 | 设置为 true 禁用所有写入操作 |
工具
市场数据（只读）
| 工具 | 说明 |
|---|---|
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与现场经纪账户互动。在金融市场交易涉及损失风险。作者对使用本软件造成的任何经济损失不承担任何责任。使用风险由您自行承担，并始终独立验证数据。
许可证
麻省理工学院 --谢尔盖·日丹诺夫