monomcp by 0xac - MCP Server

MonoMCP Workspace

Unified MCP Server Implementation + Universal External Server Proxy

Overview

This workspace contains two integrated projects that work together to provide the most comprehensive MCP operation suite available:

MonoMCP Reference Server - 106 internal operations
Grand Unification DevKit v2 - 7 external server proxies (120+ operations)

Combined Total: 225+ operations in one unified interface

Quick Start

Installation

Install both MonoMCP and the Grand Unification DevKit in one command:

cd /home/0xac/workspace/monomcp
./install_all.sh

This installs:

✅ MonoMCP Reference Server with all internal operations
✅ Grand Unification DevKit v2 proxy client
✅ Proxy operations integrated into MonoMCP's execute_operation

Verify Installation

# Check MonoMCP operations (should show 109 operations)
cd monomcp-reference-server
python -c "from monomcp.server import dispatcher; print(f'Total operations: {len(dispatcher.list_operations())}')"

# Run tests
pytest tests/
cd ../grand-unification-devkit-v2 && pytest tests/test_*mcp.py

Architecture

MonoMCP Reference Server (106 operations)

Core Categories:

Users (5 operations)
Files (4 operations)
Shell (1 operation)
Filesystem (6 operations)
Data (2 operations)
Search (1 operation)
System (2 operations)
Process (2 operations)
Git (9 operations)
Sysadmin (2 operations)
Database (8 operations)
Browser (5 operations)
Container (5 operations)
Research (20 operations)
Multimodal (15 operations)
Analysis (15 operations)
Help (4 operations)

New: Proxy Operations (3 operations)

proxy.connect - Connect to external MCP server
proxy.list_operations - List operations from external server
proxy.execute - Execute operation on external server

Grand Unification DevKit v2 (7 external servers, 120+ operations)

Integrated External Servers:

father-mcp - Testing evaluation & grading (2 ops)
claude-agents - Agent orchestration (multiple ops)
guier-mcp - GUI automation (multiple ops)
perplexity-mcp - AI search (multiple ops)
metathink-mcp - OSINT intelligence (multiple ops)
voicer-mcp - Voice AI & TTS (41 ops)
imger-mcp - Image generation & GUI analysis (23 ops)

Usage

Using MonoMCP Internal Operations

from monomcp.server import dispatcher

# Execute internal operation
result = await dispatcher.execute({
    "operation": "users.get",
    "parameters": {"user_id": "123"}
})

Using Proxy Operations (External Servers)

from monomcp.server import dispatcher

# Connect to external server and list operations
result = await dispatcher.execute({
    "operation": "proxy.list_operations",
    "parameters": {
        "transport": "stdio",
        "command": "/path/to/python -m voicer_mcp.server",
        "env": {"ELEVENLABS_API_KEY": "..."}
    }
})

# Execute operation on external server
result = await dispatcher.execute({
    "operation": "proxy.execute",
    "parameters": {
        "transport": "stdio",
        "command": "/path/to/python -m imger_mcp.server",
        "operation_name": "generate_image",
        "parameters": {"prompt": "A beautiful sunset"},
        "env": {"PYTHONPATH": "/path/to/imger-mcp"}
    }
})

Project Structure

/monomcp/
├── monomcp-reference-server/     # Core MCP server (106 operations)
│   ├── src/monomcp/
│   │   ├── operations/           # Internal operations
│   │   │   ├── proxy.py         # NEW: Proxy operations
│   │   │   └── ...              # All other operations
│   │   ├── server.py            # MCP server with proxy integration
│   │   └── dispatcher.py        # Operation router
│   ├── tests/                   # Test suite
│   └── pyproject.toml
│
├── grand-unification-devkit-v2/  # External server proxy
│   ├── src/monomcp_proxy/
│   │   └── client.py            # Universal MCP proxy client
│   ├── tests/                   # 24 tests, all passing
│   └── pyproject.toml
│
├── install_all.sh               # Unified installer
└── README.md                    # This file

Testing

Test MonoMCP Internal Operations

cd monomcp-reference-server
pytest tests/

Test External Server Proxies

cd grand-unification-devkit-v2
pytest tests/test_*mcp.py -v

Test Results:

MonoMCP: All internal operation tests passing
Proxy: 24/24 tests passing (100%)
Total: 7 external servers validated

Features

MonoMCP Reference Server

✅ 106 internal operations across 17 categories
✅ Single-tool operation multiplexing
✅ Progressive disclosure via help system
✅ Constitutional compliance & security
✅ Comprehensive error handling
✅ NEW: Proxy operations for external servers

Grand Unification DevKit v2

✅ Universal MCP proxy client
✅ 7 external servers integrated
✅ 120+ operations available
✅ Dynamic operation discovery
✅ Environment variable support
✅ Zero mocks - all tests use real servers
✅ Connection lifecycle management

Development

Add New Internal Operation

Add to monomcp-reference-server/src/monomcp/operations/ and register in server.py.

Add New External Server

Create test file in grand-unification-devkit-v2/tests/test_YOUR_SERVER.py
Test with MCPProxyClient
Use via proxy.execute operation

Run Development Server

cd monomcp-reference-server
python -m monomcp.server

Documentation

MonoMCP Docs: /monomcp-reference-server/README.md
DevKit Docs: /grand-unification-devkit-v2/README.md
Integration Plans: INTEGRATION_*.md files
Specifications: SPECIFICATION*.md files

Statistics

Combined Ecosystem:

Internal Operations: 106
Proxy Operations: 3
External Server Operations: 120+
Total Operations: 225+

Test Coverage:

MonoMCP Tests: Comprehensive
Proxy Tests: 24/24 passing (100%)
Mock Usage: 0 (ZERO!)

Development:

TDD Compliance: 100%
Constitutional Compliance: 100%
Production Ready: ✅

License

See individual project directories for license information.

Authors

MonoMCP Team
Grand Unification DevKit v2 Contributors

Status: Production Ready
Version: MonoMCP 0.1.0 + DevKit v2 1.0.0
Last Updated: October 26, 2025