项目简介

OSIM MCP 服务器是一个专门用于访问和查询 OSIM 数据标准的工具，为安全领域的 AI 应用提供标准化的数据结构定义。通过该服务器，AI 助手可以轻松获取各类安全相关的标准字段定义，包括日志格式、告警类型、资产信息等，帮助生成符合行业标准的查询语句和数据格式。

主要功能

• Schema 列表查询：获取所有可用的数据标准 schema 名称
• Schema 描述获取：了解指定 schema 的用途和适用场景
• 字段定义查看：获取 schema 的完整字段结构，包括字段名、类型、要求级别和描述
• 资源访问：通过标准 URI 格式直接访问完整的 schema 文件内容
• 自动更新：支持后台自动检查并更新到最新的 schema 版本

安装步骤

1. 快速安装（推荐）：使用 'uvx' 工具直接运行，无需本地安装

   uvx osim-mcp-server
   

2. 源码运行（开发模式）：

   git clone https://github.com/osim-group/osim-mcp-server.git
   cd osim-mcp-server
   python update_schemas.py  # 必需：获取 schemas 文件
   uv sync
   uv run python server.py
   

客户端配置

在 MCP 客户端（如 Claude Desktop、Cursor）中添加以下配置：

Claude Desktop（配置文件：'~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "osim-mcp-server": {
      "command": "uvx",
      "args": ["osim-mcp-server"]
    }
  }
}

Cursor（在 MCP 设置中添加）：

{
  "mcpServers": {
    "osim-mcp-server": {
      "command": "uvx",
      "args": ["osim-mcp-server"]
    }
  }
}

基本使用方法

服务器启动后，AI 助手可以通过以下方式使用：

1. 查看所有可用 schema：使用 'list_schema_names' 工具获取完整的 schema 列表

2. 了解 schema 用途：使用 'describe_schemas' 工具获取指定 schema 的描述信息

3. 获取字段定义：使用 'get_schema' 工具查询指定 schema 的完整字段结构

4. 直接访问资源：通过 URI 格式 'data-standard://{group}/{category}/{title}' 获取完整文件内容

示例查询：

• "列出所有可用的安全数据标准"
• "获取 HTTP 审计日志的字段定义"
• "查看网络攻击告警的标准字段"