Metadata-Version: 2.4
Name: forge-mcp-server
Version: 0.1.0
Summary: MCP server for dependency-ordered repository ingestion via qwen3-repo
Project-URL: Repository, https://github.com/ArkaD171717/forge-mcp-server
Author: ArkaD171717
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: context,ingestion,mcp,qwen,repository
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: qwen3-repo>=0.1.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# forge-mcp-server

MCP server for dependency-ordered repository ingestion. Wraps [qwen3-repo](https://pypi.org/project/qwen3-repo/) as two MCP tools that any MCP-compatible client can call.

Works with LobeChat, LibreChat, AnythingLLM, Claude Desktop, and any other MCP client.

## Tools

### ingest_local_repo

Ingest a local directory into a dependency-ordered context pack.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| path | string | (required) | Absolute path to the repository directory |
| max_tokens | int | 64000 | Maximum token budget for the context pack |
| model | string | Qwen3.6-27B | Model name for tokenizer budget calculation |

### ingest_remote_repo

Clone and ingest a remote git repository.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| url | string | (required) | Git URL to clone |
| branch | string | "" | Branch to clone (empty = default branch) |
| max_tokens | int | 64000 | Maximum token budget for the context pack |
| model | string | Qwen3.6-27B | Model name for tokenizer budget calculation |

## Installation

```
pip install forge-mcp-server
```

Or with uvx (no install needed):

```
uvx forge-mcp-server
```

## Configuration

Add to your MCP client config (e.g. Claude Desktop, LobeChat, LibreChat, AnythingLLM):

```json
{
  "mcpServers": {
    "forge-repo-ingest": {
      "command": "forge-mcp-server"
    }
  }
}
```

Or with uvx:

```json
{
  "mcpServers": {
    "forge-repo-ingest": {
      "command": "uvx",
      "args": ["forge-mcp-server"]
    }
  }
}
```

## Development

```
pip install -e ".[dev]"
pytest
```

## License

Apache-2.0
