Metadata-Version: 2.4
Name: tenzir-mcp
Version: 0.4.1
Summary: MCP server for Tenzir
Project-URL: Homepage, https://github.com/tenzir/mcp
Project-URL: Repository, https://github.com/tenzir/mcp
Project-URL: Documentation, https://docs.tenzir.com/reference/mcp-server
Project-URL: Source, https://github.com/tenzir/mcp
Project-URL: Bug Tracker, https://github.com/tenzir/mcp/issues
Author-email: Tenzir <engineering@tenzir.com>
Maintainer-email: Tenzir Engineering <engineering@tenzir.com>
License: Apache-2.0
License-File: LICENSE
Keywords: data-pipeline,mcp,model-context-protocol,ocsf,secdataops,secops,security,tenzir
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Monitoring
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: fastmcp>=0.2.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: tenzir-changelog>=0.8.1
Requires-Dist: tenzir-test>=0.12.0
Description-Content-Type: text/markdown

# ⚙️ Tenzir MCP Server

[![PyPI](https://img.shields.io/pypi/v/tenzir-mcp.svg)](https://pypi.org/project/tenzir-mcp)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that
enables AI assistants to interact with [Tenzir](https://tenzir.com)—a data
pipeline engine for security operations.

This MCP server provides tools for executing pipelines written in the [Tenzir
Query Language (TQL))](https://docs.tenzir.com/explanations/language), working
with Open Cybersecurity Schema Framework (OCSF), managing packages, generating parsers, and exploring documentation.

## ✨ Features

- **Pipeline Execution**: Run TQL pipelines and tests
- **Documentation Access**: Search and browse embedded Tenzir documentation with
  cross-reference support
- **OCSF Integration**: Query and work with OCSF definitions, event classes,
  objects, and profiles.
- **Package Management**: Create and manage Tenzir packages with operators,
  pipelines, enrichment contexts, and tests
- **Code Generation**: Auto-generate TQL parsers and OCSF mapping packages

## 📦 Installation

Use Docker as the fastest way to get started:

```bash
docker run -i tenzir/mcp
```

Or use [`uvx`](https://docs.astral.sh/uv/) when you have a local Tenzir
installation:

```bash
uvx tenzir-mcp
```

## 📚 Documentation

- [Setup
  instructions](https://docs.tenzir.com/guides/mcp-usage/install-mcp-server),
  including MCP client configurations
- [Reference](https://docs.tenzir.com/guides/reference/mcp-server),
  including usage and tool overview

## 🧑‍💻 Development

See [DEVELOPMENT.md](DEVELOPMENT.md) for development setup, testing, and
contributing guidelines.

## 📜 License

This project is licensed under the [Apache License 2.0](LICENSE).
