Drive Api

🚀 MCP Server

This project is an MCP (Multi - Agent Conversation Protocol) Server tailored for the provided OpenAPI URL - https://api.apis.guru/v2/specs/googleapis.com/drive/v3/openapi.json. It's auto - generated using AG2's MCP builder, offering a seamless solution for multi - agent conversations.

🚀 Quick Start

Before diving into the MCP Server, ensure you've met the necessary prerequisites and followed the installation steps.

✨ Features

• Auto - generated based on the given OpenAPI URL.
• Supports multiple transport modes like stdio, sse, and streamable - http.
• Comes with a comprehensive set of development tools for linting, static analysis, and testing.

📦 Installation

Prerequisites

• Python 3.9+
• pip and uv

Steps

1. Clone the repository:

   git clone <repository-url>
   cd mcp-server
   

2. Install dependencies: The .devcontainer/setup.sh script simplifies dependency installation using pip install -e ".[dev]". If you're not using the dev container, you can run this command manually.

   pip install -e ".[dev]"
   

   Alternatively, you can use uv:

   uv pip install --editable ".[dev]"
   

💻 Usage Examples

Development

This project integrates several useful tools for development.

Linting and Formatting

To check for linting issues:

ruff check

To format the code:

ruff format

These commands are also accessible via the scripts/lint.sh script.

Static Analysis

To run static analysis (mypy, bandit, semgrep):

./scripts/static-analysis.sh

This script is configured as a pre - commit hook in .pre-commit-config.yaml.

Running Tests

To run tests with coverage:

./scripts/test.sh

This will run pytest and generate a coverage report. For a combined report and cleanup, you can use:

./scripts/test-cov.sh

Pre - commit Hooks

This project uses pre - commit hooks defined in .pre-commit-config.yaml. To install the hooks:

pre-commit install

The hooks will run automatically before each commit.

Running the Server

The MCP server can be launched using the mcp_server/main.py script, supporting different transport modes (e.g., stdio, sse, streamable - http).

Basic Usage

To start the server (e.g., in stdio mode):

python mcp_server/main.py stdio

Configuration

The server can be configured using environment variables:

• CONFIG_PATH: Path to a JSON configuration file (e.g., mcp_server/mcp_config.json).
• CONFIG: A JSON string containing the configuration.
• SECURITY: Environment variables for security parameters (e.g., API keys).

Refer to the if __name__ == "__main__": block in mcp_server/main.py for details on how these are loaded.

The tests/test_mcp_server.py file shows how to start and interact with the server programmatically for testing.

Building and Publishing

This project uses Hatch for building and publishing.

Building

hatch build

Publishing

hatch publish

These commands are also available via the scripts/publish.sh script.