金融AI助手服务器

Financial AI Assistant MCP Server 是一个集成了多种金融数据源的服务器,通过统一的Model Context Protocol (MCP)注册表提供市场数据、SEC文件和可重用提示。

  • by Anastasiia-Selezen
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Anastasiia-Selezen/finAssistant_mcpserver

使用说明

金融AI助手MCP服务器

金融AI助手MCP服务器将多个金融数据源组合在一起 FastMCP 注册表,以便代理可以通过模型上下文协议(MCP)获取市场数据、SEC文件和可重用的提示。

特性

  • 统一的MCP注册表,公开Alpha Vantage市场数据、SEC文件和可重复使用的财务分析提示。
  • 上的可流式HTTP传输 localhost:5555 用于与MCP兼容客户端集成。

需求

安装

  1. 克隆存储库并切换到项目目录。
  2. 安装依赖项: uv sync

配置

服务器从环境变量加载设置(可选地通过 .env 文件)。这些密钥是强制性的,并在启动时进行验证:

变量 描述
ALPHA_VANTAGE_API_KEY Alpha Vantage REST API密钥。
SEC_API_KEY sec-api.io密钥由使用 SECClient.

重命名 .env.example 文件到 .env 文件,并在运行服务器之前添加API密钥或将其导出到shell中。

运行MCP服务器

在本地启动注册表:

uv run src/main.py

默认情况下,FastMCP注册表会监听 streamable-http://localhost:5555.

可用的MCP工具

阿尔法Vantage(alphavantage_*)

  • alphavantage.get_intraday(symbol, interval) --OHLCV日内数据。
  • alphavantage.get_news_sentiment(tickers, topics?, time_from?, time_to?) --头条情绪推送。
  • alphavantage.search_symbol(keywords) --从公司名称中解析股票代码。

所有AlphaVantage调用都使用您的API密钥代理到托管MCP端点。

秒(sec_*)

  • sec.map_ticker_to_cik(ticker) --将股票代码转换为CIK标识符。
  • sec.get_latest_10k_metadata(ticker) --最近10-K文件的元数据。
  • sec.get_latest_10k_text(ticker, sections?) --提取10-K文本(可选地仅限于以下部分 1, 7等等)。

这些工具依赖于 sec-api SDK。

代理范围提示(scope_*)

  • scope.financial_analysis_prompt(query) --格式化一个结构化的分析提示,促使下游代理在回答之前计划工具的使用。