Metadata-Version: 2.4
Name: iflow-mcp_teabranch-agentic_developer
Version: 0.1.0
Summary: MCP Server for Agentic Developer
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: anyio
Requires-Dist: click
Requires-Dist: pydantic>=2.0.0
Requires-Dist: mcp
Requires-Dist: uvicorn
Requires-Dist: fastmcp

# Agentic Developer MCP Server

An MCP server implementation that clones a Git repository and runs Codex on its contents.

## Overview

This MCP server provides a tool for cloning a Git repository, optionally checking out a specific branch, focusing on a particular folder, and running Codex with a given request.

## Installation

```bash
# Install the package in development mode
pip install -e .
```

## Usage

You can run the MCP server using either stdio or SSE transport:

```bash
# Using stdio (default)
python -m mcp_server

# Using SSE on a specific port
python -m mcp_server --transport sse --port 8000
```

## Tool Documentation

### run_codex

Clones a repository, checks out a specific branch (optional), navigates to a specific folder (optional), and runs Codex with the given request.

#### Parameters

- `repository` (required): Git repository URL
- `branch` (optional): Git branch to checkout
- `folder` (optional): Folder within the repository to focus on
- `request` (required): Codex request/prompt to run

#### Example

```json
{
  "repository": "https://github.com/username/repo.git",
  "branch": "main",
  "folder": "src",
  "request": "Analyze this code and suggest improvements"
}
```

## Development

This project uses the MCP Python SDK to implement an MCP server. The primary implementation is in `mcp_server/server.py`.

## License

MIT
