使用说明

项目简介

IMF数据MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 应用提供访问国际货币基金组织 (IMF) 公开经济数据的能力。通过此服务器，LLM可以获取IMF数据集列表、数据集结构、时间序列数据、指标列表和国家列表，并利用预设的Prompt模板指导用户进行数据查询。

主要功能点

数据集列表 (Resource): 获取IMF所有可用数据集的清单。
数据集结构 (Resource): 查询特定数据集的结构信息，了解数据构成。
时间序列数据查询 (Tool): 根据用户指定的频率、国家、指标和时间范围，检索IMF数据库中的时间序列数据。支持多个IMF数据库，包括IFS, DOT, BOP, CDIS, CPIS, GFSMAB, MFS, FSI。
指标列表 (Tool): 列出特定数据集可用的指标代码和名称，帮助用户选择合适的指标进行查询。
国家列表 (Tool): 获取特定数据集支持的国家或地区列表，辅助用户设定查询范围。
查询Prompt模板 (Prompt): 提供预定义的Prompt模板，指导用户如何构建有效的IMF数据查询请求。

安装步骤

本服务器支持两种安装方式：

方式一：使用 'uv' (推荐)

无需额外安装步骤，直接使用 'uvx' 命令运行服务器：

uvx imf-data-mcp

方式二：使用 'pip'

使用 'pip' 安装 'imf-data-mcp' 包：

pip install imf-data-mcp

安装完成后，使用以下命令启动服务器：

python -m imf_data_mcp

服务器配置

MCP客户端需要配置服务器连接信息，以下是IMF数据MCP服务器的典型配置示例，客户端需要配置 'mcpServers' 字段，指定服务器名称 (例如 "imf")，以及启动服务器的命令和参数。

{
  "mcpServers": {
    "imf": {
      "command": "uvx",
      "args": ["imf-data-mcp"]
    }
  }
}

参数说明:

'server name': 服务器名称，例如 "imf"，客户端用此名称引用服务器。
'command': 启动服务器的命令。如果使用 'uv' 安装，推荐使用 '"uvx"'；如果使用 'pip' 安装，则使用 '"python -m imf_data_mcp"'。
'args': 命令参数，对于本服务器，参数为 '["imf-data-mcp"]'。

基本使用方法

启动服务器: 根据上述安装步骤，选择 'uvx imf-data-mcp' 或 'python -m imf_data_mcp' 命令启动IMF数据MCP服务器。
配置MCP客户端: 在MCP客户端的配置文件中，添加上述服务器配置信息，确保客户端能够找到并连接到IMF数据MCP服务器。
使用LLM客户端: 通过LLM客户端，可以调用IMF数据MCP服务器提供的资源 (Resources)、工具 (Tools) 和 Prompt模板 (Prompts)，例如：
- 使用 'imf://datasets' 资源获取数据集列表。
- 使用 'list_countries' 工具获取国家列表。
- 使用 'fetch_ifs_data' 工具查询国际金融统计 (IFS) 数据。
- 使用 'imf_query_prompt' Prompt模板获取查询指导。

请参考MCP客户端的文档，了解如何配置和使用MCP服务器。

关键词