使用说明

项目简介

本项目 'mcp-dst' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将丹麦统计局 (Danmarks Statistik) 的 Statistikbank API 转化为易于大型语言模型 (LLM) 访问和利用的资源。通过此服务器，LLM 应用可以便捷地查询丹麦的各类统计数据，进行数据驱动的分析和应用开发。

主要功能点

数据资源访问: 提供对丹麦统计局 API 中 “主题 (subjects)”，“表格 (tables)”，“表格元数据 (tableinfo)”，“数据 (data)” 等核心资源的访问能力。
API 参数支持: 支持丹麦统计局 API 的所有原始参数，用户可以灵活地定制数据查询条件。
多格式数据返回: 支持 JSON, JSONSTAT, CSV 等多种数据格式，满足不同 LLM 应用的数据处理需求。
易于集成: 专为与支持 MCP 协议的 LLM 应用集成而设计，简化数据接入流程。
自然语言交互: 配合 LLM，终端用户可以通过自然语言提问，由 AI 助手自动检索相关数据并生成易于理解的答案。

安装步骤

安装 Python 依赖: 确保您的 Python 环境 (Python 3.9+) 中已安装 'mcp' 和 'requests' 库。如果未安装，请在命令行中运行以下命令：
```
pip install mcp requests
```
下载仓库代码: 从 GitHub 仓库 mcp-dst 下载源代码，或使用 'git clone https://github.com/Brokk-Sindre/mcp-dst.git' 克隆到本地。
运行服务器: 在仓库根目录下，打开命令行工具，运行以下命令启动 MCP 服务器：
```
python server.py
```
服务器默认使用 'stdio' 传输协议，并在终端输出日志信息。

服务器配置

对于 MCP 客户端，您需要配置连接到此 MCP 服务器的必要信息。以下是一个 JSON 格式的配置示例，您需要将其填入 MCP 客户端的服务器配置中。

{
  "server_name": "Danmarks Statistik API Server",
  "command": "python",
  "args": ["server.py"],
  "transport": "stdio"
}

配置参数说明:

'server_name': 服务器的名称，可以自定义，用于在客户端中标识该服务器。例如: '"Danmarks Statistik API Server"'。
'command': 启动服务器的命令。由于服务器是 Python 脚本 'server.py'，此处应设置为 '"python"'。
'args': 启动命令的参数列表。这里需要指定运行的 Python 脚本文件名，即 '["server.py"]'。
'transport': 指定 MCP 服务器使用的传输协议。本项目默认使用 'stdio'，因此设置为 '"stdio"'。

基本使用方法

启动 MCP 服务器: 按照上述安装步骤运行 'server.py'。
配置 MCP 客户端: 在您的 MCP 客户端应用中，添加上述提供的服务器配置信息。确保客户端能够成功连接到 MCP 服务器。
资源 URI: 客户端通过特定的资源 URI 访问丹麦统计数据。以下是一些可用的资源 URI 示例：
- 'statbank://subjects': 获取顶级主题列表。
- 'statbank://subjects/{subject_id}': 获取特定主题的子主题，例如 'statbank://subjects/02' 获取 "人口和选举" 主题下的子主题。
- 'statbank://tables': 获取所有可用的表格列表。
- 'statbank://tableinfo/{table_id}': 获取特定表格的元数据信息，例如 'statbank://tableinfo/folk1c' 获取 "人口普查" 表格的元数据。
- 'statbank://data/{table_id}/{variables}/{format}/{timeOrder}/{lang}/{valuePresentation}': 获取特定表格的数据。参数需要根据实际需求进行配置，例如 'statbank://data/folk1c/FORMAT:JSONSTAT' 获取 "folk1c" 表格的 JSONSTAT 格式数据。
工具调用: 您还可以通过工具调用来访问 API 功能。例如，使用 'get_subjects' 工具获取主题数据，'get_tables' 工具获取表格数据等。具体的工具和参数可以参考 'server.py' 文件中的 '@mcp.tool()' 注解部分。

请参考仓库中的 'server.py' 文件和代码注释，了解更详细的 API 参数和使用方法。结合支持 MCP 协议的 LLM 客户端，即可构建基于丹麦统计数据的智能应用。

关键词