What is Mcp Safe Run

mcp-safe-run is a secure launcher that allows users to run their existing MCP servers without hardcoding sensitive information like API keys in configuration files.

Use cases

Use cases include securely managing API keys for applications, running MCP servers in a secure manner without exposing sensitive information, and integrating with existing workflows without requiring code changes.

How to use

To use mcp-safe-run, download the latest release from the Releases page, install it, and then start the launcher to run your MCP servers securely.

Key features

Key features include secure management of secrets, no modifications required to existing configurations, easy integration into workflows, and cross-platform compatibility (Windows, macOS, Linux).

Where to use

mcp-safe-run can be used in any environment where MCP servers are deployed, particularly in development and production settings where security is a concern.

MCP Safe Run 🚀

Welcome to the MCP Safe Run repository! If you’re tired of hardcoding secrets like API keys in your MCP client configuration files (like mcp.json or claude_desktop_config.json), you’re in the right place. The mcp-secure-launcher allows you to run your existing MCP servers securely without modifying them.

Table of Contents

1. Features
2. Installation
3. Usage
4. Configuration
5. Contributing
6. License
7. Support
8. Contact

Features 🌟

• Secure Management of Secrets: Store your API keys and other sensitive information securely.
• No Modifications Required: Run your existing MCP servers without changing your configuration files.
• Easy Integration: Simple setup process that integrates seamlessly with your current workflow.
• Cross-Platform Compatibility: Works on Windows, macOS, and Linux.

Installation ⚙️

To get started, download the latest release from our Releases page. Once downloaded, execute the file to install the mcp-secure-launcher.

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (version 14 or later)
• npm (Node Package Manager)

Step-by-Step Guide

1. Download the Release: Visit the Releases page and download the latest version.
2. Execute the Installer: Run the downloaded file to install the launcher.
3. Verify Installation: Open your terminal and type mcp-secure-launcher --version to confirm the installation.

Usage 📦

Using mcp-secure-launcher is straightforward. Follow these steps to start running your MCP servers securely.

Starting the Launcher

Open your terminal and type the following command:

mcp-secure-launcher start

This command will initiate the launcher and load your MCP server configuration.

Adding Secrets

To add secrets, use the following command:

mcp-secure-launcher add-secret <key> <value>

Replace <key> with the name of your secret and <value> with the actual secret.

Running Your MCP Server

Once your secrets are added, run your MCP server with:

mcp-secure-launcher run <server_name>

Replace <server_name> with the name of your server configuration.

Configuration ⚙️

Configuration Files

The launcher reads from a configuration file named mcp-config.json. Here’s a sample structure:

{
  "servers": [
    {
      "name": "MyServer",
      "port": 8080,
      "secrets": {
        "API_KEY": "your_api_key_here"
      }
    }
  ]
}

Environment Variables

You can also configure secrets using environment variables. Set the variables in your terminal before starting the launcher:

export API_KEY="your_api_key_here"

Contributing 🤝

We welcome contributions to MCP Safe Run! If you’d like to help, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them.
4. Push to your branch.
5. Create a pull request.

Code of Conduct

Please read our Code of Conduct before contributing.

License 📄

This project is licensed under the MIT License. See the LICENSE file for details.

Support 🛠️

If you encounter any issues, please check the Issues section for existing solutions. If your issue isn’t listed, feel free to create a new issue.

Contact 📬

For questions or feedback, please reach out to us via GitHub or email us at [email protected].

Thank you for checking out MCP Safe Run! We hope it makes managing your MCP servers easier and more secure. Don’t forget to visit our Releases page for the latest updates and downloads.