i
itick-mcp-server
oneAzz/itick-mcp-server
1 Stars
56 次浏览
更新于 2026-08-23
一个Python MCP服务器，它通过iTick REST API提供各种金融数据服务，包括股票、加密货币、外汇、指数、期货和基金。该服务支持单笔与批量的Tick、Quote、Depth及K线数据。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"itick": {
"args": [
"-m",
"itick_mcp_server"
],
"command": "python3",
"cwd": "/absolute/path/to/itick-mcp-server",
"env": {
"ITICK_TOKEN": "your_token"
}
}
}
}该服务需要配置环境变量：ITICK_TOKEN
服务介绍
itick-mcp-server
Python MCP server exposing iTick REST API as tools: 基础数据、股票（含信息 / IPO / 复权因子）、以及 Crypto / Forex / Indices / Future / Fund 各产品线的单笔与批量 Tick / Quote / Depth / Kline。
未实现文档中的 WebSocket、FIX（非 REST）。
Setup
cd itick-mcp-server
pip install -e .
# 若只有 python3：pip3 install -e .
环境变量：
| 变量 | 说明 |
|---|---|
ITICK_TOKEN |
必填（实际调用时）：请求头 token，见 官方文档 |
ITICK_API_BASE |
可选，默认 https://api.itick.org（与文档示例一致）。若你环境使用 https://api.itick.io，可设为该地址 |
export ITICK_TOKEN="your_token"
# export ITICK_API_BASE="https://api.itick.io"
Run (stdio)
itick-mcp
# 或
python3 -m itick_mcp_server
Cursor / Claude Desktop
{
"mcpServers": {
"itick": {
"command": "itick-mcp",
"env": {
"ITICK_TOKEN": "your_token"
}
}
}
}
未装到 PATH 时（安装 editable 后一般可省略 PYTHONPATH）：
{
"mcpServers": {
"itick": {
"command": "python3",
"args": ["-m", "itick_mcp_server"],
"cwd": "/absolute/path/to/itick-mcp-server",
"env": {
"ITICK_TOKEN": "your_token"
}
}
}
}
MCP 工具一览（53）
与 REST 文档 路径对应：
基础
symbolList→GET /symbol/listsymbolHolidays→GET /symbol/v2/holidays
股票（额外）
stockInfo→GET /stock/infostockIpo→GET /stock/ipostockSplit→GET /stock/split
各产品线（stock / crypto / forex / indices / future / fund）
| 工具名 | REST |
|---|---|
{prefix}Tick |
GET /{prefix}/tick |
{prefix}Quote |
GET /{prefix}/quote |
{prefix}Depth |
GET /{prefix}/depth |
{prefix}Kline |
GET /{prefix}/kline |
{prefix}Ticks |
GET /{prefix}/ticks |
{prefix}Quotes |
GET /{prefix}/quotes |
{prefix}Depths |
GET /{prefix}/depths |
{prefix}Klines |
GET /{prefix}/klines |
批量接口中 codes 为英文逗号分隔。K 线参数在工具中为 k_type，请求中会编码为 kType；可选 et（毫秒时间戳）、limit。
与早期 Java 示例一致的股票单笔 K 线工具名仍为 stockKline。
代码结构
itick_mcp_server/client.py— HTTP GET、ITICK_API_BASE/ITICK_TOKENitick_mcp_server/tools_register.py— 注册全部 REST 工具itick_mcp_server/server.py— FastMCP 入口
