FinX-金融人工智能代理系统
一个以学习为中心的金融人工智能代理系统，由MCP（模型上下文协议）服务器构建。旨在通过实践市场分析帮助您学习投资概念。
🎯 哲学
在实践中学习 -这不仅仅是一种投资工具；这是一个教育平台，通过将金融概念应用于真实数据来帮助你理解金融概念。
✨ 你能做什么
FinX提供了一个强大的MCP服务器，与Cursor无缝集成，帮助您学习投资：
📊 市场数据服务器
- 获取实时报价 -当前价格、市场指标和每日表现
- 探索历史数据 -分析任何时间段的价格趋势和波动性
- 研究公司 -全面的基本面、财务比率和业务见解
- 学习金融概念 -对市盈率、净资产收益率、利润率等指标的教育性解释
- 比较公司 -对同行业同行的并排分析
🚀 快速开始
先决条件
- Node.js 22.x LTS或更高版本
- pnpm 9.x或更高
- Alpha Vantage API密钥（免费层： 在这里买一个)
- 游标IDE（用于MCP集成）
安装
- 克隆和安装依赖关系：
cd finx
pnpm install- 配置环境：
cp env.example .env
# Edit .env and add:
# - Your Alpha Vantage API key (required)
# - Your Financial Modeling Prep API key (optional, for financial statements)
# - Your FRED API key (optional, for economic indicators)- 构建服务器：
pnpm build- 在游标中配置MCP：
添加到光标MCP配置(~/.cursor/mcp.json):
{
"mcpServers": {
"finx-market-data": {
"command": "node",
"args": [
"/absolute/path/to/finx/mcp-market-data/dist/index.js"
],
"env": {
"ALPHA_VANTAGE_API_KEY": "your_key_here",
"FMP_API_KEY": "your_fmp_key_here",
"FRED_API_KEY": "your_fred_key_here"
}
}
}
}⚠️ 重要提示： 替换 /absolute/path/to/finx 使用您的实际安装路径。
- 重新启动游标 加载MCP服务器
📚 学习路径
FinX逐步引导您了解投资概念，从基础到高级分析。
第一阶段：市场数据和基本面
你学到了什么：
- 阅读股票报价和了解市场数据
- 公司基本面和财务指标
- 行业比较和同行分析
- 关键财务比率（市盈率、净资产收益率、利润率等）
可用工具：
get_quote-当前价格和指标get_historical_data-价格历史get_company_info-全面的基础知识search_symbol-查找股票代码explain_fundamental-了解具体指标compare_peers-并排公司比较
学习提示：
learn-concept.md-深入了解财务指标decode-financials.md-了解一家公司compare-stocks.md-通过比较学习
第二阶段：财务报表分析
你学到了什么：
- 资产负债表分析
- 损益表解释
- 现金流量分析
- 估值模型和方法
- 教育背景下的比率计算
- 行业和部门分析框架
学习提示：
- 高级财务报表分析提示
- 估值模型指南
- 特定部门分析框架
推荐阅读：
- 本杰明·格雷厄姆的《聪明的投资者》
- 伯顿·麦基尔的《漫步华尔街》
- 菲利普·费舍尔的《普通股和非普通利润》
- 彼得·林奇的《华尔街上的一个人》
🛠️ 技术栈
- 运行时间： Node.js 22.x LTS
- 包管理器： pnpm 9.x
- 市场数据： Alpha Vantage+雅虎财经（后备）+财务建模准备（财务报表）+FRED（经济指标）
📖 文档
快速入门指南
- 用法.md -完整的使用指南，包含真实世界的示例
- 学习.md -如何将此系统用于金融教育
- QUICKSTART.md -探索工具的互动指南
技术文档
- MONOREPO.md -Monorepo结构和工作空间管理（面向开发人员）
- .游标 -人工智能学习行为指南
- .cursor/提示/ -结构化学习提示
知识库
- .cursor/知识/ -您的个人金融知识库
- 概念/ -财务概念文件
- 期刊/ -投资决策日志
- 框架/ -投资框架
🎮 面向开发者
测试
pnpm test # Run all unit tests
pnpm test:watch # Watch mode
pnpm test:coverage # With coverage
pnpm test:e2e # Integration tests (spawns MCP server, tests all tools)发展
pnpm dev:market-data # Watch mode for Market Data server🤝 贡献
这是一个个人学习项目。请随意分叉并适应您的需求。
⚠️ 免责声明
此软件仅用于教育目的。这不是财务建议。在做出投资决策之前，一定要咨询合格的财务顾问。过去的表现并不能保证未来的结果。
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件