Osim Mcp Server

Name: Osim Mcp Server
Author: osim-group

@osim-group

About Osim Mcp Server

OSIM MCP Server is a standardized MCP server implementation providing structured security data standards for AI applications.

#osim #mcp #server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

列出所有可用的数据标准 schema 名称。返回对象列表，每个对象包含： - title: schema 名称，格式为 {group}.{category}.{title}（例如：log.network_session_audit.http_audit） - label: schema 的英文标签（来自 schema 文件） - label_{locale}: schema 的各语言标签（动态生成，根据 i18n 目录下的文件自动生成）例如：如果存在 zh_CN.json，则会有 label_zh_CN 字段；如果存在 en_US.json，则会有 label_en_US 字段如需获取描述，请使用 describe_schemas 工具。 Returns: List[Dict[str, Any]]: schema 信息列表，每个对象包含 title、label 和动态的 label_{locale} 字段

获取指定 schema 名称列表的描述信息。参数 schema_names 是 schema 名称列表，格式为 {group}.{category}.{title} （例如：["log.network_session_audit.http_audit", "alert.network_attack.apt_attack"]）。返回字典，键为 schema 名称，值为描述信息，方便理解应该使用哪个 schema。

获取指定 schema 的字段定义。参数 schema_path 格式为 {group}.{category}.{title} （例如：log.network_session_audit.http_audit），可以从 list_schema_names 中获取所有可用的 schema 名称。返回字段定义字典，包含字段名、标签、类型、要求、描述等信息。

获取当前 schemas 的版本信息。返回包含本地版本号和更新状态的字典。 Returns: Dict[str, Any]: 包含 version（版本号）和 auto_update_enabled（是否启用自动更新）的字典

获取 dictionaries.json 文件内容。返回 OSIM 数据标准中定义的字典项，包含字段名、标签、描述、类型等信息。这些字典项定义了数据标准中使用的通用字段定义。 Returns: Dict[str, Any]: dictionaries.json 的完整内容，如果读取失败则返回包含错误信息的字典

Overview

What is Osim Mcp Server?

Osim Mcp Server is a FastMCP‑based Model Context Protocol (MCP) server that provides query and access capabilities for OSIM (Open Security Information Model) data standard schemas. It is designed for developers and security professionals who need to retrieve schema definitions covering alerts, assets, logs, incidents, and device detections.

How to use Osim Mcp Server?

Run instantly with uvx osim-mcp-server (no installation required) or clone the repository, execute python update_schemas.py to fetch schemas, then run uv sync && uv run python server.py. Configure the server in MCP clients such as Claude Desktop or Cursor by adding the command uvx osim-mcp-server to the client’s MCP settings. The server exposes three tools (list_schema_names, describe_schemas, get_schema) and resource URIs in the format data-standard://{group}/{category}/{title}.

Key features of Osim Mcp Server

Provides three MCP tools to list, describe, and retrieve schema definitions.
Serves schema content via MCP resource URIs.
Supports OSIM data standards: Alert, Asset, Log, Incident, Device Detection.
Schema files are fetched from the OSIM Schema GitHub repository.
Built on FastMCP and follows the Model Context Protocol specification.
Can be run without installation via uvx from PyPI.

Use cases of Osim Mcp Server

Query available OSIM data standard schema names for integration.
Describe the purpose of specific schemas (e.g., log.network_session_audit.http_audit).
Retrieve full field definitions (name, type, requirement) for a given schema.
Configure in MCP clients (Claude Desktop, Cursor) to enrich AI‑assisted security workflows.

FAQ from Osim Mcp Server

What dependencies does Osim Mcp Server require?

Python 3.10+, FastMCP 2.0+, and git (for updating schemas) are required.

Where do the schema files come from?

All schema files originate from the OSIM Schema repository.

Do I need to prepare schemas before running the server?

Yes, the repository does not include a schemas directory. You must run python update_schemas.py before starting the server.

What transport does Osim Mcp Server use?

The README does not specify a transport; it is assumed to use the standard MCP transport (stdio) when run via uvx or from the command line.

Is authentication required?

No authentication or API key is mentioned in the README.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K