DHIS2 AI连接服务

DHIS2 MCP服务器

DHIS2 MCP服务器将AI工具直接连接到DHIS2实例。这使AI代理、助手和聊天机器人能够读取和管理DHIS2数据，执行分析，管理元数据，并通过自然语言交互自动化工作流程。

用例

• 数据管理：提交、检索和验证DHIS2数据条目
• 分析和报告：生成报告、创建可视化和分析健康数据
• 元数据管理：管理组织单位、数据元素、程序和指标
• 用户管理：创建用户、分配角色和管理权限
• 系统监控：检查系统状态、运行维护任务并监控性能

专为希望将人工智能工具与DHIS2上下文和功能连接的健康数据管理者而设计。

快速开始

先决条件

1. 转到1.21或更高版本
2. 访问DHIS2实例（演示可在https://play.dhis2.org/dev)
3. MCP兼容客户端（带MCP扩展的VS Code、Claude Desktop等）

安装

使用Docker（推荐）

docker run -d \
  -e DHIS2_URL=https://play.dhis2.org/dev \
  -e DHIS2_USERNAME=admin \
  -e DHIS2_PASSWORD=district \
  ghcr.io/smalljoe1/dhis2-mcp-server

从源代码构建

git clone https://github.com/Smalljoe1/dhis2-mcp-server
cd dhis2-mcp-server
go build -o dhis2-mcp-server ./cmd/dhis2-mcp-server
./dhis2-mcp-server stdio

MCP客户端配置

VS代码配置

{
  "servers": {
    "dhis2": {
      "command": "./dhis2-mcp-server",
      "args": ["stdio"],
      "env": {
        "DHIS2_URL": "https://your-dhis2-instance.org",
        "DHIS2_USERNAME": "your-username",
        "DHIS2_PASSWORD": "your-password"
      }
    }
  }
}

可用工具

系统上下文

• get_system_info -检索DHIS2系统信息
• get_me -获取当前用户配置文件
• test_connection -测试DHIS2连接

元数据管理

• get_organisation_units -通过按级别、父级、搜索词和限制进行筛选来检索组织单位
• get_data_elements -通过按搜索词、域类型、值类型和限制进行筛选来检索数据元素
• search_metadata -使用单个查询跨多个元数据对象（组织单元、数据元素等）进行搜索

数据操作 （即将推出）

• get_data_values -检索数据值
• submit_data_values -提交数据条目
• validate_data_completeness -检查数据完整性

分析 （即将推出）

• get_analytics_data -查询分析API
• generate_pivot_table -创建数据透视表
• export_report -生成和导出报告

环境变量

• DHIS2_URL -DHIS2实例URL（必需）
• DHIS2_USERNAME -身份验证用户名
• DHIS2_PASSWORD -身份验证密码
• DHIS2_TOKEN -个人访问令牌（用户名/密码的替代品）
• DHIS2_TOOLSETS -以逗号分隔的要启用的工具集列表
• DHIS2_READ_ONLY -设置为“true”为只读模式

开发状态

该项目正在积极开发中。当前实施状态：

• [x] 基本MCP服务器结构
• [x] DHIS2身份验证和客户端
• [x] 系统上下文工具
• [x] 元数据工具（组织单位、数据元素、搜索）
• []数据操作工具 （下一优先级）
• []分析工具
• []Docker部署
• []VS代码集成示例
• []综合文件

测试

测试DHIS2连接和功能：

# Test connection to DHIS2 demo instances
go run ./cmd/test-connection

# Build and run tests
go build -o bin/test-connection.exe ./cmd/test-connection
./bin/test-connection.exe

# Run unit tests
go test ./...

贡献

欢迎投稿！请阅读我们的 贡献指南 了解详情。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

• 文档
• 问题
• 讨论