关键词

Fintual API 集成金融数据工具LLM 扩展上下文服务

项目简介

这是一个基于 Model Context Protocol (MCP) 构建的服务器，专门用于集成 Fintual 的公开 API。通过这个服务器，支持 MCP 协议的语言模型 (LLM) 客户端可以调用预定义的功能（工具）来查询 Fintual 的金融相关数据，例如资产提供者和银行列表。

主要功能点

  • 访问 Fintual API: 封装了对 Fintual API 多个端点的访问，如获取资产提供者信息、根据 ID 查询特定提供者、获取概念性资产以及获取银行列表。
  • 提供工具接口: 将 Fintual API 的功能封装成 LLM 可调用的“工具”，允许 LLM 在对话过程中根据需要获取实时数据。
  • 定义Prompt模板: 提供与 Fintual 数据相关的 Prompt 模板，帮助 LLM 更好地理解用户意图并组织回答。
  • 与MCP客户端通信: 通过标准 MCP 协议（如 Stdio）与兼容的 LLM 客户端（如 Claude Desktop, Cursor, CodeGPT 等）进行通信。

安装步骤

  1. 克隆仓库: 
    git clone https://github.com/davila7/fintual_mcp_server.git
cd fintual_mcp_server
  2. 安装uv: 
    curl -LsSf https://astral.sh/uv/install.sh | sh
    确保 'uv' 可执行文件路径在你的系统 PATH 中，或者记录下其完整路径。

服务器配置（供MCP客户端使用）

MCP服务器需要由MCP客户端启动和管理。你需要在你使用的MCP客户端的配置中，添加关于这个Fintual MCP服务器的信息。配置信息通常是一个JSON结构，你需要提供服务器的名称、启动命令及其参数。

根据此仓库的信息，客户端配置应包含以下关键信息：

  • 服务器名称 (Server Name): 'Fintual MCP Server'
  • 启动命令 (Command): 'uv' 可执行文件的完整路径。例如：'/path_to_your_uv/.local/bin/uv'
  • 命令参数 (Arguments): 启动服务器所需的参数列表。这是一个字符串数组，应包含：
    • 'run'
    • '--with'
    • 'mcp[cli]'
    • 'mcp'
    • 'run'
    • Fintual Python 服务器主文件（'main.py'）的完整路径。例如：'<path to mcp-servers>/fintual_mcp_server/fintual_python_server/main.py'

请将上述 Command 和 Arguments 中的路径占位符替换为你系统中 'uv' 和服务器文件 'main.py' 的实际路径。

这个配置信息通常被放置在MCP客户端特定的配置文件中，例如：

  • Claude Desktop: 'claude_desktop_config.json'
  • Cursor: '.cursor/mcp.json'
  • CodeGPT: '~/.codegpt/mcp_config.json'

请查阅你使用的具体MCP客户端的文档，了解如何添加或修改MCP服务器配置。

基本使用方法

配置完成后，当你在支持MCP的LLM客户端中与模型交流时，如果你的问题与Fintual的资产提供者或银行信息相关，LLM可能会识别到可以利用Fintual MCP服务器提供的工具来回答你的问题。

  1. 提问: 向LLM提出关于Fintual资产提供者或银行的问题。例如：
    • 'Zurich 是一个 Fintual 的资产管理者吗?'
    • 'Fintual 集成了哪些银行?'
    • 'BANCHILE 有哪些概念性资产?'
  2. LLM调用工具: LLM可能会根据你的问题判断需要调用Fintual MCP服务器上的某个工具（例如 'asset_providers' 或 'banks'）。通常LLM会请求你的确认才能执行工具调用。
  3. 获取并展示结果: 服务器执行工具调用，访问Fintual API获取数据，并将结果返回给LLM。LLM会阅读API响应，并利用其中的信息来生成答案，展示给你。

通过这种方式，LLM能够获取并利用实时的外部数据来增强其回答能力。

信息

分类

AI与计算

访问项目