osim-mcp-server 1.0.1

OSIM MCP Server based on FastMCP

OSIM MCP Server

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

🚀 快速开始

使用 uvx（推荐，无需安装）

如果包已发布到 PyPI，可以直接使用 uvx 运行：

uvx osim-mcp-server

在 MCP 客户端中配置

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"]
    }
  }
}

从源码运行

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

# 安装依赖并运行
uv sync
uv run python server.py

📚 功能特性

MCP 工具

1. list_schema_names - 列出所有可用的数据标准 schema 名称

   • 返回格式：{group}.{category}.{title}
   • 示例：log.network_session_audit.http_audit

2. describe_schemas - 获取指定 schema 的描述信息

   • 参数：schema_names (List[str])
   • 返回：字典，键为 schema 名称，值为描述信息

3. get_schema - 获取指定 schema 的完整字段定义

   • 参数：schema_path (str)，格式为 {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
  • data-standard://asset/business_asset/web_application

📊 数据标准分类

项目提供完整的 OSIM 数据标准支持，包括：

• 告警 (Alert)：异常行为、数据安全、恶意软件、网络攻击等
• 资产 (Asset)：业务资产、云资产、数据资产、网络资产等
• 日志 (Log)：账户操作审计、数据安全审计、主机行为审计、网络会话审计等
• 事件 (Incident)：安全事件记录和分类
• 设备检测 (Device Detection)：EDR、防火墙、WAF、IDS/IPS 等各类安全设备

数据来源：所有 schema 文件均来源于 OSIM 开源工程

🛠️ 开发

构建分发包

uv build

发布到 PyPI

# 安装 twine
uv pip install twine

# 上传到 PyPI
uv run twine upload dist/*

发布后即可通过 uvx osim-mcp-server 使用。

📝 许可证

MIT License

🙏 致谢

• FastMCP - MCP 服务器框架
• Model Context Protocol - MCP 协议规范
• OSIM 开源工程 - 数据标准 schema 文件资源