1mcpserver

1mcpserver

MCP of MCPs. Automatically discover, configure, and add MCP servers on your local machine.

23
Stars
5
Forks
0
Releases

Overview

1 MCP Server is an umbrella MCP that discovers and configures MCP servers automatically on your local machine, reducing manual setup. It is designed to be the sole MCP server you need; once installed, you can leave searching, selecting, and configuring other MCP servers to this central server. Setup does not require running setup commands or obtaining API keys—config is done by editing a single mcp.json file. The README provides two setup approaches: a simple remote setup that points Cursor or Claude to a discovery endpoint with appropriate headers, and a local STDIO-based setup that runs with uv and server.py, optionally merging with other local file-system MCPs. The system supports merging multiple mcpServers entries in one file and executing local or remote server processes via the mcp.json. The architecture describes two search modes (quick search and deep search) and a three-stage workflow (planning, testing, acting). As of 0.2.0, agentic planning introduces multi-step MCP server querying. The repository includes guidance on testing with a test_server_template_code tool to verify server health.

Details

Owner
particlefuture
Language
Python
License
Apache License 2.0
Updated
2025-12-07

Features

Automatic discovery and configuration

Automatically discovers MCP servers and configures them on your local machine, reducing manual setup.

Single orchestrator

A central MCP server coordinates and configures multiple MCP servers so you don't manage each one individually.

Simple JSON-based configuration

Uses a single mcp.json file to define MCP servers, with the ability to merge with existing entries and specify headers for remote endpoints.

Two deployment modes

Supports remote setup (Cursor/Claude integration) and local STDIO transport for running MCP servers.

Flexible integration with existing MCPs

Can co-exist with other MCP servers in the same mcp.json (e.g., file-system) to create a unified configuration.

Testing and validation workflow

Includes a test_server_template_code tool workflow to verify server health and connectivity.

Deep search architecture

Supports quick search for simple intents and deep search for complex goals, including planning, testing, and acting stages.

Agentic planning (0.2.0)

Adds agentic planning to prompt the LLM for multi-step MCP server queries on complex tasks.

Audience

DevelopersAutomatically discover and configure MCP servers on local machines for development.
DevOps teamsAutomate MCP server discovery, orchestration, and remote integration tasks for streamlined infrastructure management.

Tags

MCPdiscoveryautomationserver-configurationlocal-setupremote-setupCursorClaudestdiojson-config