Brest MCP Server

🚀 Brest MCP Server

Brest MCP Server is a server implementation of the Model Context Protocol (MCP) in the Brest region. It offers a robust and reliable infrastructure for managing MCP - based interactions and includes an MCP inspection tool for debugging and monitoring.

🚀 Quick Start

Installation

To install and configure the Brest MCP Server locally, follow these steps:

1. Install uv (if not already installed):

   • On Linux/macOS:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   • On Windows:

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

2. Clone the repository:

   git clone https://github.com/Nijal-AI/Brest-mcp-server.git
   cd Brest-mcp-server
   

3. Create and activate a virtual environment:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

4. Install dependencies:

   uv sync
   

Usage

To run the local server, follow these steps:

1. Ensure the virtual environment is activated:

   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

2. Start the server using the MCP inspection tool:

   npx @modelcontextprotocol/inspector uv run brest-mcp
   

3. Access the MCP inspection tool in your browser:

   • Proxy: http://localhost:3000
   • Web interface: http://localhost:5173

Example output:

Starting the MCP inspection tool...
Proxy server listening on port 3000
🔍 MCP inspection tool is running at http://localhost:5173 🚀

✨ Features

Brest MCP Server provides a powerful and reliable infrastructure for managing MCP - based interactions. Its goal is to simplify and reliably deploy and manage MCP services. It also includes an MCP inspection tool for debugging and monitoring.

📦 Installation

The installation steps are detailed in the "Quick Start - Installation" section above.

💻 Usage Examples

Basic Usage

The basic steps to run the server are described in the "Quick Start - Usage" section.

Advanced Usage

If you want to interact with an AI agent using the Brest MCP Server, you can use the client in the tools directory:

uv run python tools/client.py src/server.py

📚 Documentation

Technologies

• Language: Python 3.12.3 or compatible versions
• Dependency Management: uv
• Inspection Tool: The MCP inspection tool via Node.js (npx)
• Environment: A virtual environment managed by uv
• Node.js: Used for the MCP inspection tool

Tools

You can use the client in the tools directory to interact with AI agents using the Brest MCP Server.

Development

For developers who wish to contribute or develop advanced features, follow these additional steps:

1. Ensure the virtual environment is set up and dependencies are installed:

uv venv
uv sync

2. Use the MCP inspection tool for debugging and monitoring:

npx @modelcontextprotocol/inspector uv run brest-mcp

3. Refer to the pyproject.toml file for detailed information about dependencies and configuration.

Contributing

Contributions are welcome! To propose changes, refer to the CONTRIBUTING.md file.

📄 License

This project is under the MIT License. For detailed information, see the LICENSE file.