mcpzip 0.1.0

MCP proxy that aggregates multiple servers behind search + execute meta-tools
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

---
sidebar_position: 7
---

# Contributing

Contributions are welcome! Here's how to get started.

## Development Setup

```bash
git clone https://github.com/hypercall-public/mcpzip.git
cd mcpzip
cargo build
cargo test
```

## Running Tests

```bash
# Run all tests (150+)
cargo test

# Run a specific test module
cargo test proxy::handlers

# Run with output
cargo test -- --nocapture
```

## Project Structure

```
src/
  main.rs              # Entry point
  lib.rs               # Module declarations
  config.rs            # Config loading + validation
  error.rs             # Error types
  types.rs             # Core types (ToolEntry, ServerConfig, ProxyConfig)
  cli/                 # CLI commands (serve, init, migrate)
  auth/                # OAuth 2.1 + token persistence
  proxy/               # ProxyServer + meta-tool handlers
  catalog/             # Tool catalog + disk cache
  search/              # Keyword + LLM search
  transport/           # Connection pool + stdio/http/sse
  mcp/                 # MCP protocol types + server/client
```

## Guidelines

- Run `cargo test` before submitting a PR
- Follow existing code patterns and naming conventions
- Add tests for new functionality
- Keep the binary size small — be conservative with dependencies

## Reporting Issues

Open an issue at [github.com/hypercall-public/mcpzip/issues](https://github.com/hypercall-public/mcpzip/issues).

Include:
- mcpzip version (`mcpzip --version`)
- Your config (redact secrets)
- Steps to reproduce
- Expected vs actual behavior