OSIM MCP Server

基于 Spring AI 的 Model Context Protocol (MCP) 服务器，为 AI 应用提供 OSIM (Open Security Information Model) 数据标准 schema 的查询和访问能力。

特性

• 完整的 OSIM 数据标准支持：涵盖告警、资产、日志、事件和设备检测等 5 大分类、200+ 种数据标准定义
• 标准 MCP 协议：提供 listSchemaNames、describeSchemas、getSchema 工具和资源访问接口
• 高性能：基于 Spring Boot，启动时间 ~1.5 秒，支持 STDIO 通信，无端口占用
• 易于集成：兼容所有支持 MCP 的 AI 客户端（Claude Desktop、Cursor 等）

快速开始

前置要求

• Java 25+
• Gradle 8.0+（或使用项目自带的 Gradle Wrapper）

安装与运行

# 克隆仓库
git clone https://github.com/osim-group/osim-mcp-server.git
cd osim-mcp-server

# 构建项目（会自动下载最新的 schemas）
./gradlew build

# 运行服务器
./gradlew bootRun

或使用打包后的 JAR：

java -jar build/libs/osim-mcp-server-1.0.0.jar

配置

服务器默认通过 STDIO 方式运行，配置文件位于 src/main/resources/application.properties：

# MCP Server Configuration
spring.ai.mcp.server.enabled=true
spring.ai.mcp.server.stdio=true
spring.ai.mcp.server.name=osim-mcp-server
spring.ai.mcp.server.version=1.0.0

# Schema Repository Configuration
osim.schema.repository.url=https://raw.githubusercontent.com/osim-group/osim-schema/main/schemas
osim.schema.github.auto-update=false

配置说明：

• spring.main.web-application-type=none：禁用 Web 服务器，使用 STDIO 通信
• osim.schema.github.auto-update：false 使用内置 schemas（快速启动），true 自动获取最新版本

使用指南

MCP 工具

listSchemaNames

列出所有可用的 schema 名称，格式：{group}.{category}.{title}

示例：

• log.network_session_audit.http_audit
• alert.network_attack.apt_attack
• asset.business_asset.web_application

describeSchemas

获取指定 schema 列表的描述信息。

参数：schemaNames (List)

getSchema

获取指定 schema 的完整字段定义。

参数：schemaPath (String)，格式：{group}.{category}.{title}

MCP 资源

通过资源 URI 访问 schema 文件内容：

URI 格式：data-standard://{group}/{category}/{title}

示例：

• data-standard://log/network_session_audit/http_audit
• data-standard://alert/network_attack/apt_attack

集成示例

Claude Desktop

在配置文件中添加：

{
  "mcpServers": {
    "osim-mcp-server": {
      "command": "java",
      "args": ["-jar", "/path/to/osim-mcp-server-1.0.0.jar"]
    }
  }
}

Cursor

在 MCP 配置中添加：

{
  "mcpServers": {
    "osim-mcp-server": {
      "command": "java",
      "args": ["-jar", "/path/to/osim-mcp-server-1.0.0.jar"]
    }
  }
}

数据标准资源

数据标准来源：项目内置 schemas（构建时打包到 jar），支持从 osim-group/osim-schema 自动更新。

项目结构

osim-mcp-server/
├── src/main/java/ai/osim/osimmcpserver/
│   ├── OsimMcpServerApplication.java
│   ├── config/McpServerConfiguration.java
│   ├── loader/DataStandardLoader.java
│   ├── resource/DataStandardResourceConfiguration.java
│   └── service/DataStandardService.java
├── src/main/resources/
│   ├── application.properties
│   └── schemas/          # 内置数据标准 schema 文件
├── build.gradle
└── README.md

开发

# 构建项目
./gradlew build

# 运行测试
./gradlew test

# 下载 schemas
./gradlew downloadSchemas

贡献

欢迎贡献！请遵循以下步骤：

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

许可证

本项目采用 Apache License 2.0 许可证。详情请参阅 LICENSE 文件。

致谢

• Spring AI - MCP 服务器框架
• Model Context Protocol - MCP 协议规范
• OSIM Schema - 数据标准 schema 资源

相关链接

• Spring AI 文档
• Model Context Protocol 规范
• [GitHub Is

... View full README on GitHub