📊 FinanceMCP-Alpha（金融MCP-阿尔法）
](https://www.npmjs.com/package/finance-mcp-alpha) 
一个强大的 模型上下文协议（MCP） 用于计算的服务器 WorldQuant 101 Alpha因子 使用Tushare提供的实时中国股市数据。采用TypeScript构建，专为量化交易分析和研究设计。
✨ 特点/功能
- 🎯 目标 7个阿尔法因子Alpha3，Alpha13，Alpha15，Alpha16，Alpha44，Alpha50，Alpha55
- 📈 代表上升的箭头或图表趋势，常用于表示数据增长、价格上涨等。 实时数据集成了Tushare API以获取A股市场数据
- 🔒（锁形符号，常用于表示安全、保密或锁定状态） 安全通过HTTP头部进行基于令牌的身份验证
- 🚀 表示火箭或快速上升/前进的符号。 可流式传输的HTTP支持现代MCP协议
- 📊（表格） 综合分析详细的因子统计和交易信号
- 🎨（美术、绘画相关的表情符号，无具体文字对应，可理解为“美术”或“绘画”等意象） 精美的报告带有视觉指示器的Markdown格式分析
🏗️ 建筑学
src/
├── index.ts # MCP server entry point
├── tools/
│ └── calculate_alpha.ts # Alpha calculation tool
├── alphas/
│ └── index.ts # Alpha factor implementations
└── utils/
├── tushare.ts # Tushare API client
└── operators.ts # Mathematical operators📦 安装
选项1：作为npm包使用
npm install finance-mcp-alpha选项2：在本地克隆并构建
git clone https://github.com/guangxiangdebizi/FinanceMCP-Alpha.git
cd FinanceMCP-Alpha
npm install
npm run build🚀 快速入门
1. 启动服务器
npm start服务器将在 http://localhost:3000 默认情况下。
🚀 FinanceMCP-Alpha Server Started
=====================================
Transport: Streamable HTTP
MCP Endpoint: http://localhost:3000/mcp
Health Check: http://localhost:3000/health
=====================================2. 配置MCP客户端
添加到您的MCP客户端配置中（例如。， mcp.json （或Claude Desktop配置）：
{
"mcpServers": {
"finance-alpha": {
"type": "streamableHttp",
"url": "http://localhost:3000/mcp",
"headers": {
"X-Tushare-Token": "YOUR_TUSHARE_TOKEN_HERE"
},
"timeout": 600
}
}
}⚠️ 重要获取您的免费Tushare令牌，请访问 https://tushare.pro/register 翻译为中文是：“https://tushare.pro/注册”。不过，通常在中文语境下，网址本身不会被翻译，而是直接保留原样，同时在说明中加入中文解释。所以，更自然的表达可能是：“网址：https://tushare.pro/register（用于注册）”
3. 使用该工具
一旦连接成功，您就可以使用 calculate_alpha 工具：
Calculate Alpha factors for stock 000001.SZ from 20240101 to 20241011
with factors Alpha3, Alpha13, Alpha50📖 Alpha因子
这个包实现了以下WorldQuant 101阿尔法因子：
Alpha#3（阿尔法三）
公式： (-1 * correlation(rank(open), rank(volume), 10))\ 用例开盘价排名与成交量排名之间呈负相关关系。高值表明价格与成交量呈现反向变动。
Alpha#13
公式： (-1 * rank(covariance(rank(close), rank(volume), 5)))\ 用例捕捉收盘价与成交量之间的相关性排名。识别价格-成交量异常。
Alpha#15（阿尔法15号）
公式： (-1 * sum(rank(correlation(rank(high), rank(volume), 3)), 3))\ 用例高价与成交量之间排名相关性的总和。用于检测短期动量变化。
Alpha#16
公式： (-1 * rank(covariance(rank(high), rank(volume), 5)))\ 用例类似于Alpha13，但侧重于利用高价数据来分析日内波动模式。
Alpha#44
公式: (-1 * correlation(high, rank(volume), 5))\ 用例高价与成交量排名呈负相关。识别出成交量与价格高点的背离情况。
Alpha#50
公式： (-1 * ts_max(rank(correlation(rank(volume), rank(vwap), 5)), 5))\ 用例成交量与成交量加权平均价（VWAP）之间的最大排名相关性。衡量成交量-价格效率。
Alpha#55
公式： (-1 * correlation(rank((close - ts_min(low, 12)) / (ts_max(high, 12) - ts_min(low, 12))), rank(volume), 6))\ 用例标准化价格位置与成交量之间的相关性。捕捉动量与成交量之间的关系。
🔧 工具参数
calculate_alpha
| 参数 | 类型 | 必填 | 描述 | |||||
|---|---|---|---|---|---|---|---|---|
| 中文翻译 | 英文 | 日文 | 韩文 | stock_code | 000001.SZ | 字符串 | ✅ | TuShare格式的股票代码（例如。， 600000.SH， |
| ） | start_date | YYYYMMDD | 字符串 | ✅ | 开始日期在 20240101格式（例如。， | |||
| ) | end_date | YYYYMMDD | 字符串 | ✅ | 结束日期在 20241011格式（例如。， | |||
| ) | factors | ["Alpha3", "Alpha13", "Alpha15", "Alpha16", "Alpha44", "Alpha50", "Alpha55"] | 数组 | ✅ | 因子列表： |
|
- 股票代码格式深圳证券交易所
XXXXXX.SZ：000001.SZ（例如。， - - 平安银行上海证券交易所
XXXXXX.SH：600000.SH（例如。，
- 社民党银行 (SPD Bank)
📊 输出格式
- 该工具返回一份包含以下内容的综合Markdown报告： 📈 这个符号在中文里通常被用来表示“📈上升趋势”或者“📈图表上升”，它是一个表示上升或增长趋势的箭头图标。在没有具体上下文的情况下，我们通常将其翻译为“📈上升趋势”或类似的表达，以传达其基本含义。因子汇总表
- 当前值、百分位数和信号 🔍 翻译成中文是：🔍（这个符号本身没有直接的中文翻译，但在中文语境中，它通常被用来表示“放大镜”或“搜索”的意思，类似于英文中的“🔍”所代表的含义，即用于搜索或查找信息。）不过，如果仅就这个符号本身而言，它在中文里并没有特定的翻译，更多是根据上下文来理解其含义。详细分析
- 每个因素的统计指标 💡（这个符号通常表示“灯泡”，在中文里可以翻译为“💡”或者用文字描述为“灯泡图标”）交易信号
- 基于百分位数分析的买入/卖出/持有建议 🎯 目标（或“瞄准”）总体建议
来自所有因素的综合信号
信号解释
| 百分位数 | 信号 | 表情符号 | 动作 |
|---|---|---|---|
| ≥ 80% | 强烈买入 | 🟢 | 强烈买入机会 |
| 60%-80% | 买入 | 🟢 | 中等买入机会 |
| 40-60% | 持有 | 🟡 | 中立，等待更明确的信号 |
| 20-40% | 出售 | 🔴 | 中等的抛售压力 |
| \< 20% | 强烈卖出 | 🔴 | 强烈的卖出压力 |
- 🔐 安全注意事项 永远不要承诺
- 将你的Tushare令牌纳入版本控制
- 在您的MCP客户端配置中安全地存储令牌
- 使用环境变量进行服务器配置
令牌通过HTTP头传递，不存储在服务器上
# Install dependencies
npm install
# Build TypeScript
npm run build
# Run in development mode
npm run dev
# Start production server
npm start🛠️ 开发
📝 环境变量 .env 创建一个
PORT=3000文件（可选）：
🧪 测试
curl http://localhost:3000/health测试健康检查端点：
{
"status": "healthy",
"transport": "streamable-http",
"activeSessions": 0,
"serverInfo": {
"name": "FinanceMCP-Alpha",
"version": "1.0.0"
}
}预期响应：
- 📚 使用场景量化交易
- 将阿尔法因子融入您的交易策略中研究
- 分析不同股票和时间段下的因子有效性投资组合管理
- 使用因子信号来确定头寸规模并进行再平衡市场分析
- 理解价格-成交量关系和市场微观结构人工智能辅助交易
利用大型语言模型（LLMs）进行实时因子计算
🤝 贡献
欢迎贡献！请随时提交拉取请求。
📄 许可证 这个项目采用Apache License 2.0许可协议 - 请参阅 许可证
文件中有详细信息。
⚠️ 免责声明 此软件仅供教育和研究用途。
阿尔法因子是统计指标，不应作为投资决策的唯一依据。过去的表现并不能保证未来的收益。在做出投资决策前，请务必进行充分研究，并咨询财务专业人士。
👤 作者
- 陈兴宇
- @广西德比 💼 LinkedIn（领英）:
- 陈兴宇
- @邢宇辰
📧 电子邮件：guangxiangdebizi@gmail.com
- 🙏 致谢WorldQuant（世通量化）
- 对于Alpha101因子公式Tushare（通达信数据接口，或特指该金融数据平台）
- 为提供全面的中国股市数据模型上下文协议
对于令人惊叹的MCP框架
______________________________________________________________________
模型上下文协议规范
⭐ 如果你觉得这个项目有帮助，请在GitHub上给它点个星吧！