# NiFiMCP

> NiFiMCP is an open-source MCP server for developer tools. Read-only Apache NiFi investigation that cites evidence and drafts flow changes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, CLI, self-hosted
- **Website:** https://nifimcp.com
- **Repository:** https://github.com/nifimcp/nifimcp
- **MCP Registry name:** io.github.nifimcp/nifimcp
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-14

## About

NiFiMCP is aimed at people who inherit a NiFi estate with hundreds of processors and no manual. Its core rule is that every statement links to the source bytes it came from, and evidence, inference and unknowns are kept apart: in its sample, a flow file takes the unmatched route because an expected attribute is absent, while the history of the routing rule stays flagged as unknown.

It has three modes: a demo that replays a captured synthetic flow with no NiFi or model needed, a bundle mode for air-gapped review of registered definitions, and a live mode that reads one NiFi 2.12.0 instance over HTTPS with mutual TLS using a read-only identity. Flow drafts are local files that a person imports separately. Executing changes with approval is a roadmap item, and no tool in this release changes NiFi.

This is a 0.1.0rc1 public preview tested on Linux with Python 3.12 and Claude Code. Paid help for deployment is sold separately by Federal SI.

## Features

- **Cited evidence:** Every statement links to its source bytes.
- **Three modes:** Demo, bundle for air-gapped review, and live.
- **Read-only identity:** Uses a scoped client certificate with view-only policies.
- **Reviewable flow drafts:** Proposes changes as local files, not live edits.
- **Offline kit:** Hash-locked wheels, SBOM and licences for no-internet installs.
- **Honest unknowns:** Separates evidence from inference.

## Good for

- Explain an inherited flow to a new operator
- Find why a feed went to an unmatched relationship
- Review queues and status during routine operations
- Share an evidence bundle of a failure for offline review

## Install

### Claude Code (Terminal)

```sh
claude mcp add nifimcp -- uvx nifimcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nifimcp": {
      "command": "uvx",
      "args": [
        "nifimcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nifimcp": {
      "command": "uvx",
      "args": [
        "nifimcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nifimcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nifimcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nifimcp": {
      "command": "uvx",
      "args": [
        "nifimcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nifimcp": {
      "command": "uvx",
      "args": [
        "nifimcp-server"
      ]
    }
  }
}
```

## Tools

- `trace_feed`: Traces a feed through provenance, including unmatched history.

## FAQ

### Can it change my NiFi?

No. Live access is read-only and this release has no tool that changes NiFi.

### What does it need?

Python 3.12 and, for live mode, NiFi 2.12.0 over HTTPS with mutual TLS.

### Can I try it without NiFi?

Yes, the demo replays captured evidence with no NiFi, model or account.

### Is support available?

Deployment and hands-on support are offered separately through Federal SI.

### Is NiFiMCP free?

Yes. NiFiMCP is open source, so you can use and self-host it for free.

### How do I add NiFiMCP to Claude Code?

Run this command in your terminal: claude mcp add nifimcp -- uvx nifimcp-server

### What are the best alternatives to NiFiMCP?

The closest alternatives to NiFiMCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/nifimcp
