1mcpserver

1# [1 MCP Server](https://mcp.1mcpserver.com/) 🚀
2 
3[![Website](https://img.shields.io/badge/Website-mcp.1mcpserver.com-blue?style=flat-square&logo=google-chrome)](https://mcp.1mcpserver.com/)
4 
5> **MCP of MCPs** — automatically discover and configure MCP servers on your machine (remote or local).
6 
7After setup, you can usually just say:
8 
9> “I want to perform . Call the `deep_search` tool and follow the outlined steps.”
10 
11The goal is that you only install **this** MCP server, and it handles the rest (searching servers, selecting servers, configuring servers, etc.).
12 
13### Demo video 🎥: [https://youtu.be/W4EAmaTTb2A](https://youtu.be/W4EAmaTTb2A) 
14 
15## Quick Setup
16Choose **one** of the following:
17 
181. **Remote** (simplest & fastest ⚡💨)
192. **Local (prebuilt)** — **Docker**, **uvx**, or **npx**
203. **Local (from source)** — run this repo directly
21 
22### 1) Remote 🌍⚡💨
23 
24Use the hosted endpoint (recommended for the simplest setup).
25 
26**Docs + guided setup:** [https://mcp.1mcpserver.com/](https://mcp.1mcpserver.com/)
27 
28#### Configure your MCP client
29 
30Add the following entry to your client config file:
31 
32* **Cursor**: `./.cursor/mcp.json`
33* **Gemini CLI**: `./gemini/settings.json` (see Gemini docs)
34* **Claude Desktop**:
35  * macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
36  * Windows: `%APPDATA%\Claude\claude_desktop_config.json`
37* **Codex**: 
38  * macOS: `~/.codex/config.toml`
39  * Windows: `%USERPROFILE%\.codex\config.toml`
40 
41**Remote config (JSON):**
42 
43```json
44{
45  "mcpServers": {
46    "1mcpserver": {
47      "url": "https://mcp.1mcpserver.com/mcp/",
48      "headers": {
49        "Accept": "text/event-stream",
50        "Cache-Control": "no-cache"
51      }
52    }
53  }
54}
55```
56 
57If you already have other servers configured, just merge this entry under `mcpServers` For example:
58 
59```json
60{
61  "mcpServers": {
62    "1mcpserver": {
63      "url": "https://mcp.1mcpserver.com/mcp/",
64      "headers": {
65        "Accept": "text/event-stream",
66        "Cache-Control": "no-cache"
67      }
68    },
69    "file-system": {
70      "command": "npx",
71      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
72    }
73  }
74}
75```
76 
77**Tip:** If your client supports it, move the config file into your **home directory** to apply globally.
78 
79---
80 
81### 2) Local (prebuilt) 💻
82 
83Use this when you want everything local, or when your MCP client only supports **STDIO**.
84 
85#### 2A) Docker 🐳
86```bash
87 docker run -p 8080:8080 ghcr.io/particlefuture/1mcpserver:latest
88```
89Running on other host ports: 
90```bash
91 docker run -p <FREE_HOST_PORT_NUM>:8080 ghcr.io/particlefuture/1mcpserver:latest
92```
93Running with stdio instead of streamable-http (You might see some delays when trying to connect): 
94```bash
95run --rm -i ghcr.io/particlefuture/1mcpserver:latest --local
96```
97 
98```json
99{
100  "mcpServers": {
101    "1mcpserver": {
102      "url": "https://mcp.1mcpserver.com/mcp/"
103    }
104  }
105}
106```
107 
108#### 2B) npx 📦
109```bash
110npx -y @1mcpserver/1mcpserver
111```
112 
113---
114 
115### 3) Local (from source) 🧩
116 
117Clone this repo and run directly.
118 
119```bash
120git clone https://github.com/particlefuture/MCPDiscovery.git
121cd MCPDiscovery
122uv sync
123uv run server.py --local
124```
125 
126```json
127{
128  "mcpServers": {
129    "1mcpserver": {
130      "command": "/path/to/uv",
131      "args": [
132        "--directory",
133        "<PATH_TO_CLONED_REPO>",
134        "run",
135        "server.py",
136        "--local"
137      ]
138    }
139  }
140}
141```
142 
143> If your client supports remote `url` servers, you can use the **Remote** setup instead.
144 
145#### Optional: grant file-system access 📁
146 
147If you want your LLM to have file-system access, add an MCP filesystem server and point it at the directory you want to allow:
148 
149```json
150{
151  "mcpServers": {
152    "file-system": {
153      "command": "npx",
154      "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/"]
155    }
156  }
157}
158```
159 
160---
161 
162## Architecture 🧠
163 
164There are two search modes:
165 
166### Quick Search ⚡
167 
168For explicit requests like: “I want an MCP server that handles payments.”
169 
170Returns a shortlist of relevant MCP servers.
171 
172### Deep Search 🌊
173 
174For higher-level or complex goals like: “Build a website that analyzes other websites.”
175 
176The LLM breaks the goal into components/steps, finds MCP servers for each part, and if something is missing, it asks whether to:
177 
178* ignore that part,
179* break it down further, or
180* implement it ourselves.
181 
182Deep Search stages:
183 
1841. **Planning** — identify servers, keys, and config changes
1852. **Testing** — verify servers (via `test_server_template_code`)
1863. **Acting** — execute the workflow using the configured servers
187 
188---
189 
190## Change Log 🕒
191 
192* July 31 2025: Upgrade to 0.2.0. Added agentic planning.
193* Dec 12 2025: Support for Gemini + Codex
194* Dec 13 2025: Easier local setup with docker and npm. 
195 
196## Future 🔮
197 
198* Better demo videos (new domain, narrated walkthrough)
199* Model Context Communication Protocol (MCCP): standard server-to-server messaging
200* Avoid calling tools with an `internal_` prefix unless instructed
201* Improve MCP server database schema: server, description, url, config json, extra setup (docker/api key/etc)
202 
203## Credits 🙏
204 
205Data sources:
206 
207* wong2/awesome-mcp-servers
208* metorial/mcp-containers
209* punkpeye/awesome-mcp-servers
210* modelcontextprotocol/servers
211 
212Published to:
213 
214* [https://mcpservers.org/](https://mcpservers.org/)
215* [https://glama.ai/mcp/servers](https://glama.ai/mcp/servers)
216 
217## Troubleshooting 🧰
218 
219* If using a venv and you get `ModuleNotFoundError` even after installing: delete the venv and recreate it.
220 
221Please create an issue or directly contact me zjia71@gatech.edu if you encounter ANY issue of frustration. I really hope the setup is as smooth as possible!!
222 
223## Star History
224[![Star History Chart](https://api.star-history.com/svg?repos=particlefuture/1mcpserver&type=Date)](https://star-history.com/#particlefuture/1mcpserver&Date)
225