MCP Server 5s8

🚀 MCP Server

The MCP Server offers a flexible framework for AI-driven command execution and tool management.

🚀 Quick Start

The MCP Server provides a robust solution for managing AI - driven commands and tools. It has a well - structured project layout and clear installation and configuration steps.

✨ Features

• Flexible Framework: Enables AI - driven command execution and tool management.
• Multiple Tool Types: Supports command execution, asynchronous command handling, and file processing.
• Centralized Configuration: Utilizes a .env file for consistent configuration across components.

📦 Installation

Manual Installation

# Use uv (recommended):
uv pip install -e ./mcp_core
uv pip install -e ./mcp_tools
uv pip install -e .

# Or use pip:
pip install -e ./mcp_core
pip install -e ./mcp_tools
pip install -e .

This will install all local packages in development mode, allowing you to use these packages as you change the code.

📚 Documentation

Project Structure

The MCP project consists of the following parts:

• mcp_core/: Core types and adapters

  • mcp_core/tests/: Tests for core types and functions

• mcp_tools/: Utility tools and implementations

  • mcp_tools/command_executor/: Command execution tools
  • mcp_tools/tests/: Tests for utility tools

• server/: The main implementation of the MCP Server

  • server/tests/: Function tests specific to the server
  • server/.private/: Private configuration directory (ignored by git)

• scripts/: Utility scripts for project management

• assets/: Project assets and images in documentation

• config/: Centralized configuration module

  • config/templates/: Configuration templates

Environment Configuration

The MCP project uses a centralized environment configuration system based on the .env file. This allows different components to maintain consistent configurations.

Setting Up Your Environment

1. Copy the template file to create your .env file:

   cp config/templates/env.template .env
   

2. Edit the .env file to configure your environment settings:

   # Repository information
   GIT_ROOT=/path/to/git/repo
   WORKSPACE_FOLDER=/path/to/workspace
   PROJECT_NAME=mcp_project
   
   # Azure repository configuration
   AZREPO_ORG=your_organization_name
   AZREPO_PROJECT=your_project_name
   

3. Add environment variables to your terminal or IDE:

   export $(cat .env | grep -vE "^\s*#" | cut -d= -f1)
   

Configuring the MCP Server in VSCode/Cursor

It is recommended to configure the MCP Server through the .env file, but you can also override the settings in the editor configuration:

{
    "mcpServers": {
      "mymcp": {
        "command": "python",
        "args": ["server/main.py"],
        "env": {
          "GIT_ROOT": "${workspaceFolder}"
        }
      },
      "mymcp-sse" : {
        "url": "http://0.0.0.0:8000/sse"
      }
    }
}

Tool Types

• Command Execution Tools: Used to execute and manage shell commands.
• Asynchronous Command Execution: Supports Long Polling, Server - Sent Events (SSE), and WebSocket communication.
• File Processing Tools: Include file upload, download, and conversion functions.

Test Execution

You can manually run tests using pytest:

# Run all tests
python -m pytest

# Run tests for specific components
python -m pytest mcp_core/tests
python -m pytest mcp_tools/tests
python -m pytest server/tests

Example Screenshots