项目简介
Finmap MCP服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在为大型语言模型(LLM)客户端提供全面的全球股票市场数据和分析能力。它支持访问美国、英国、俄罗斯和土耳其等主要证券交易所的历史数据,包括股票代码、公司简介、市值、交易量、价值和交易计数,并支持多种可视化数据(如市值热力图、成交量柱状图)。通过标准化的JSON-RPC协议,Finmap MCP服务器能够响应LLM客户端的请求,提供丰富的金融上下文信息和数据访问功能。
主要功能点
- 列出交易所: 查询所有支持的证券交易所及其详细信息,包括交易所ID、全名、所在国家、主要交易货币、最早可用的数据日期以及数据更新频率。
- 列出行业板块: 获取指定日期特定交易所的所有可用业务行业板块列表,同时显示每个板块内包含的公司数量。
- 按行业列出股票代码: 获取指定日期特定交易所中按行业分组的公司股票代码和公司名称。可选择显示英文名称。
- 搜索公司: 根据公司名称或股票代码的部分匹配,在指定交易所查找公司并返回最佳匹配项列表,支持设置返回结果数量限制。
- 市场概览: 获取指定日期特定交易所的整体市场表现,包括总市值、总交易量、总交易价值和市场整体涨跌幅,并提供详细的行业细分数据。
- 行业表现: 获取指定日期特定交易所中各行业板块的聚合性能指标,例如行业市值、涨跌幅、交易量等。
- 股票详细数据: 获取指定日期特定交易所中指定股票代码的详细市场数据,包括开盘价、最新成交价、涨跌幅百分比、交易量、交易价值、交易笔数、市值等。
- 股票排名: 根据您选择的指标(如市值、涨跌幅、交易量、交易价值、交易笔数)对指定交易所的股票进行排名,支持升序或降序排列,并可设置返回结果的数量上限。
- 公司简介 (仅限美国): 为在美国上市的公司提供业务描述、所属行业和背景信息,通过股票代码查询。
安装步骤
本Finmap MCP服务器可通过 'npm' 包在本地安装和运行,提供更佳性能和离线访问。
- 全局安装 Finmap MCP 包:
打开终端或命令行工具,运行以下命令进行全局安装:
npm install -g finmap-mcp - 直接运行 (无需全局安装):
或者,您可以直接使用 'npx' 命令运行,而无需预先进行全局安装:
npx finmap-mcp
服务器配置(供MCP客户端连接使用)
您的MCP客户端需要知道如何连接到Finmap MCP服务器。根据您选择的部署方式,请在MCP客户端的配置界面中填写以下信息:
-
选项一:连接到 Finmap 托管的远程服务器 如果您不想在本地安装或运行任何程序,可以直接连接到Finmap提供的远程托管MCP服务器。 在您的MCP客户端配置中,通常会要求您提供以下几项:
- 服务器名称 (Server Name): 例如,您可以输入 'finmap'。
- 启动命令 (Command): 输入 'npx'。
- 命令参数 (Arguments): 按顺序输入两个参数:'mcp-remote' 和 'https://mcp.finmap.org/mcp'。 (这些参数指示您的MCP客户端使用 'mcp-remote' 工具作为桥梁,连接到指定的Finmap远程服务器地址。)
-
选项二:在本地运行服务器 如果您已按照上述“安装步骤”在本地安装了 'finmap-mcp' 包,可以运行本地服务器以获得更快的响应和离线访问能力。 在您的MCP客户端配置中,通常会要求您提供以下几项:
- 服务器名称 (Server Name): 例如,您可以输入 'finmap'。
- 启动命令 (Command): 输入 'npx'。
- 命令参数 (Arguments): 按顺序输入两个参数:'-y' 和 'finmap-mcp'。 (这些参数指示您的MCP客户端使用 'npx' 命令直接启动本地安装的 'finmap-mcp' 服务器。)
基本使用方法
LLM客户端配置并成功连接到Finmap MCP服务器后,LLM即可通过调用服务器上注册的工具来获取数据。例如,要查询可用的证券交易所,LLM可以尝试发送类似以下的指令:
#finmap-mcp list available stock exchanges
LLM将收到一个包含所有支持交易所详细信息的JSON格式响应。其他工具也可以通过类似的自然语言指令触发,LLM会根据您的请求智能选择并调用相应的工具。
信息
分类
网页与API