uer-mcp 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +44 -124
  2. package/img/uer.jpg +0 -0
  3. package/package.json +86 -3
  4. package/python/README.md +44 -124
package/README.md CHANGED
@@ -1,6 +1,46 @@
1
- # Universal Expert Registry
1
+ <div align="center">
2
+ <img src="img/uer.jpg" alt="UER Logo" width="200"/>
2
3
 
3
- > **ASI-Level Experts, Infinite Memory, Any Client**
4
+ # Universal Expert Registry
5
+
6
+ [![npm version](https://badge.fury.io/js/uer-mcp.svg)](https://www.npmjs.com/package/uer-mcp)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
+
9
+ **ASI-Level Experts, Infinite Memory, Any Client**
10
+ </div>
11
+
12
+ ---
13
+
14
+ **Standard config** works in most MCP clients:
15
+ > 💡 **Quick Start**: Get a free Gemini API key at [aistudio.google.com/api-keys](https://aistudio.google.com/api-keys)
16
+ ```json
17
+ {
18
+ "mcpServers": {
19
+ "uer": {
20
+ "command": "npx",
21
+ "args": ["uer-mcp@latest"],
22
+ "env": {
23
+ "GEMINI_API_KEY": "your-key-here"
24
+ }
25
+ }
26
+ }
27
+ }
28
+ ```
29
+
30
+
31
+
32
+ > **⚠️ Required**: Add at least one API key to the `env` section. See [CONFIGURATION.md](CONFIGURATION.md) for all provider links and detailed setup.
33
+
34
+ [<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522uer%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uer-mcp%2540latest%2522%255D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522uer%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uer-mcp%2540latest%2522%255D%257D) [<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor">](https://cursor.com/en/install-mcp?name=UER&config=eyJjb21tYW5kIjoibnB4IHVlci1tY3BAbGF0ZXN0In0%3D) [<img src="https://img.shields.io/badge/Windsurf-Windsurf?style=flat-square&label=Install%20Server&color=0B7A8F" alt="Install in Windsurf">](https://windsurf.com)
35
+
36
+ <details>
37
+ <summary>Other MCP Clients</summary>
38
+
39
+ For Claude Desktop, Goose, Codex, Amp, and other clients, see [CONFIGURATION.md](CONFIGURATION.md) for detailed setup instructions.
40
+
41
+ </details>
42
+
43
+ ---
4
44
 
5
45
  An MCP server that provides:
6
46
  1. **Universal LLM Access** - Call any LLM (Claude, GPT, Gemini, Bedrock, Azure, local models) through LiteLLM
@@ -172,129 +212,9 @@ Message 2: Continue → Progress: 60% → {{continuation: registry://plan/001}}
172
212
  Message 3: Continue → Complete! Here's your report...
173
213
  ```
174
214
 
175
- ## Quick Start
176
-
177
- ### Prerequisites
178
-
179
- - **Node.js 14+** (for npm/npx)
180
- - **Python 3.11+** (automatically detected)
181
- - **Claude Desktop** (or any MCP-compatible client)
182
- - **At least one LLM API key** (see below)
183
-
184
- **Optional but recommended:**
185
- - **uv** package manager ([installation guide](https://docs.astral.sh/uv/getting-started/installation/)) - for better dependency management
186
-
187
- ### Step 1: Get API Keys
188
-
189
- You need at least one LLM API key to use UER. We recommend starting with **Google Gemini** as it offers a free tier:
190
-
191
- #### Google Gemini (Free - Recommended for Testing)
192
-
193
- 1. Visit [https://aistudio.google.com/apikey](https://aistudio.google.com/apikey)
194
- 2. Click "Create API Key"
195
- 3. Copy your key (starts with `AIza...`)
196
- 4. Free tier includes: 10-15 requests/minute, 250K tokens/minute, 250-1000 requests/day (varies by model)
197
-
198
- #### Other Providers (Optional)
199
-
200
- | Provider | Get API Key | Free Tier |
201
- |----------|-------------|-----------|
202
- | **Anthropic** (Claude) | [console.anthropic.com](https://console.anthropic.com/) | $5 credit for new users |
203
- | **OpenAI** (GPT) | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) | $5 credit for new users |
204
- | **Azure OpenAI** | [Azure Portal](https://portal.azure.com/) | Requires Azure subscription |
205
- | **AWS Bedrock** | [AWS Console](https://console.aws.amazon.com/bedrock/) | Pay-as-you-go |
206
-
207
- ### Step 2: Installation
208
-
209
- **Option A: Using npx (Recommended - Zero Installation)**
210
-
211
- No installation needed! Just configure Claude Desktop (Step 3) and it will automatically download and run the latest version.
212
-
213
- **Option B: Manual Installation (For Development)**
214
-
215
- ```bash
216
- # Clone the repository
217
- git clone https://github.com/margusmartsepp/UER.git
218
- cd UER
219
-
220
- # Install dependencies
221
- uv sync
222
-
223
- # Build the npm package
224
- npm run build
225
- ```
226
-
227
- ### Step 3: Configure Claude Desktop
228
-
229
- Add UER as an MCP server to Claude Desktop:
230
-
231
- **Location:** `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)
232
-
233
- **Minimal Configuration (Gemini only - Using npx):**
234
- ```json
235
- {
236
- "mcpServers": {
237
- "uer": {
238
- "command": "npx",
239
- "args": ["uer-mcp@latest"],
240
- "env": {
241
- "GEMINI_API_KEY": "AIza_your_key_here"
242
- }
243
- }
244
- }
245
- }
246
- ```
247
-
248
- **Full Configuration (All providers - Using npx):**
249
- ```json
250
- {
251
- "mcpServers": {
252
- "uer": {
253
- "command": "npx",
254
- "args": ["uer-mcp@latest"],
255
- "env": {
256
- "GEMINI_API_KEY": "AIza_your_key_here",
257
- "ANTHROPIC_API_KEY": "sk-ant-...",
258
- "OPENAI_API_KEY": "sk-...",
259
- "AWS_ACCESS_KEY_ID": "...",
260
- "AWS_SECRET_ACCESS_KEY": "...",
261
- "AWS_REGION_NAME": "us-east-1",
262
- "AZURE_API_KEY": "...",
263
- "AZURE_API_BASE": "https://....openai.azure.com/"
264
- }
265
- }
266
- }
267
- }
268
- ```
269
-
270
- **Manual Installation Configuration (For Development):**
271
- ```json
272
- {
273
- "mcpServers": {
274
- "uer": {
275
- "command": "uv",
276
- "args": ["--directory", "C:\\path\\to\\UER", "run", "python", "-m", "uer.server"],
277
- "env": {
278
- "GEMINI_API_KEY": "AIza_your_key_here"
279
- }
280
- }
281
- }
282
- }
283
- ```
284
-
285
- **Important:**
286
- - For npx: No path needed, just add your API keys
287
- - For manual install: Replace `C:\\path\\to\\UER` with your actual directory
288
- - Use double backslashes `\\` on Windows, or forward slashes `/` on Mac/Linux
289
- - Only include API keys for providers you want to use
290
-
291
- ### Step 4: Restart Claude Desktop
292
-
293
- 1. Quit Claude Desktop completely
294
- 2. Reopen Claude Desktop
295
- 3. Look for the 🔨 (hammer) icon indicating MCP tools are loaded
215
+ ## Usage
296
216
 
297
- ### Step 5: Test Your Setup
217
+ ### Test Your Setup
298
218
 
299
219
  Try this in Claude Desktop:
300
220
 
package/img/uer.jpg ADDED
Binary file
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "uer-mcp",
3
- "version": "1.0.0",
4
- "description": "Universal Expert Registry - Multi-LLM MCP Server",
3
+ "version": "1.0.1",
4
+ "description": "Universal Expert Registry - Multi-LLM MCP Server with access to 100+ LLM providers, 1000+ MCP servers, and unlimited context storage",
5
5
  "main": "index.js",
6
6
  "bin": {
7
7
  "uer-mcp": "./bin/uer-mcp.js"
@@ -10,6 +10,7 @@
10
10
  "bin/",
11
11
  "dist/",
12
12
  "python/",
13
+ "img/",
13
14
  "README.md",
14
15
  "LICENSE"
15
16
  ],
@@ -21,6 +22,7 @@
21
22
  },
22
23
  "keywords": [
23
24
  "mcp",
25
+ "mcp-server",
24
26
  "llm",
25
27
  "anthropic",
26
28
  "openai",
@@ -28,7 +30,10 @@
28
30
  "claude",
29
31
  "chatgpt",
30
32
  "ai",
31
- "model-context-protocol"
33
+ "model-context-protocol",
34
+ "litellm",
35
+ "multi-agent",
36
+ "context-management"
32
37
  ],
33
38
  "author": "Margus Martsepp <margusmartsepp@gmail.com>",
34
39
  "license": "MIT",
@@ -42,5 +47,83 @@
42
47
  "homepage": "https://github.com/margusmartsepp/UER#readme",
43
48
  "engines": {
44
49
  "node": ">=14.0.0"
50
+ },
51
+ "mcp": {
52
+ "displayName": "Universal Expert Registry",
53
+ "icon": "img/uer.jpg",
54
+ "description": "Access 100+ LLM providers (Claude, GPT, Gemini, etc.), connect to 1000+ MCP servers, and manage unlimited context with external storage. Enables multi-agent workflows with subagent delegation.",
55
+ "features": [
56
+ "Universal LLM Access - Call any LLM through LiteLLM (Claude, GPT, Gemini, Bedrock, Azure, local models)",
57
+ "MCP Tool Orchestration - Connect to 1000+ MCP servers (filesystem, databases, browsers, etc.)",
58
+ "Shared Memory/Context - Break context window limits via external storage with URI references",
59
+ "Subagent Delegation - Spawn subagents with full chat history, not just single messages"
60
+ ],
61
+ "tools": [
62
+ {
63
+ "name": "llm_call",
64
+ "description": "Call any LLM provider (100+ models supported)"
65
+ },
66
+ {
67
+ "name": "mcp_call",
68
+ "description": "Call tools from other MCP servers"
69
+ },
70
+ {
71
+ "name": "put",
72
+ "description": "Store data in external context storage"
73
+ },
74
+ {
75
+ "name": "get",
76
+ "description": "Retrieve data from external context storage"
77
+ },
78
+ {
79
+ "name": "delegate",
80
+ "description": "Delegate tasks to subagents with full context"
81
+ },
82
+ {
83
+ "name": "search",
84
+ "description": "Search stored context and knowledge"
85
+ }
86
+ ],
87
+ "configuration": {
88
+ "required": [
89
+ "At least one LLM API key (GEMINI_API_KEY, ANTHROPIC_API_KEY, or OPENAI_API_KEY)"
90
+ ],
91
+ "env": {
92
+ "GEMINI_API_KEY": {
93
+ "description": "Google Gemini API key (get free at https://aistudio.google.com/api-keys)",
94
+ "required": false
95
+ },
96
+ "ANTHROPIC_API_KEY": {
97
+ "description": "Anthropic Claude API key",
98
+ "required": false
99
+ },
100
+ "OPENAI_API_KEY": {
101
+ "description": "OpenAI GPT API key",
102
+ "required": false
103
+ },
104
+ "AZURE_API_KEY": {
105
+ "description": "Azure OpenAI API key",
106
+ "required": false
107
+ },
108
+ "AZURE_API_BASE": {
109
+ "description": "Azure OpenAI endpoint URL",
110
+ "required": false
111
+ },
112
+ "AWS_ACCESS_KEY_ID": {
113
+ "description": "AWS access key for Bedrock",
114
+ "required": false
115
+ },
116
+ "AWS_SECRET_ACCESS_KEY": {
117
+ "description": "AWS secret key for Bedrock",
118
+ "required": false
119
+ },
120
+ "AWS_REGION_NAME": {
121
+ "description": "AWS region (e.g., us-east-1)",
122
+ "required": false
123
+ }
124
+ },
125
+ "quickStart": "Get a free Gemini API key at https://aistudio.google.com/api-keys - no credit card required!",
126
+ "documentation": "https://github.com/margusmartsepp/UER/blob/master/CONFIGURATION.md"
127
+ }
45
128
  }
46
129
  }
package/python/README.md CHANGED
@@ -1,6 +1,46 @@
1
- # Universal Expert Registry
1
+ <div align="center">
2
+ <img src="img/uer.jpg" alt="UER Logo" width="200"/>
2
3
 
3
- > **ASI-Level Experts, Infinite Memory, Any Client**
4
+ # Universal Expert Registry
5
+
6
+ [![npm version](https://badge.fury.io/js/uer-mcp.svg)](https://www.npmjs.com/package/uer-mcp)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
+
9
+ **ASI-Level Experts, Infinite Memory, Any Client**
10
+ </div>
11
+
12
+ ---
13
+
14
+ **Standard config** works in most MCP clients:
15
+ > 💡 **Quick Start**: Get a free Gemini API key at [aistudio.google.com/api-keys](https://aistudio.google.com/api-keys)
16
+ ```json
17
+ {
18
+ "mcpServers": {
19
+ "uer": {
20
+ "command": "npx",
21
+ "args": ["uer-mcp@latest"],
22
+ "env": {
23
+ "GEMINI_API_KEY": "your-key-here"
24
+ }
25
+ }
26
+ }
27
+ }
28
+ ```
29
+
30
+
31
+
32
+ > **⚠️ Required**: Add at least one API key to the `env` section. See [CONFIGURATION.md](CONFIGURATION.md) for all provider links and detailed setup.
33
+
34
+ [<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522uer%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uer-mcp%2540latest%2522%255D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522uer%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uer-mcp%2540latest%2522%255D%257D) [<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor">](https://cursor.com/en/install-mcp?name=UER&config=eyJjb21tYW5kIjoibnB4IHVlci1tY3BAbGF0ZXN0In0%3D) [<img src="https://img.shields.io/badge/Windsurf-Windsurf?style=flat-square&label=Install%20Server&color=0B7A8F" alt="Install in Windsurf">](https://windsurf.com)
35
+
36
+ <details>
37
+ <summary>Other MCP Clients</summary>
38
+
39
+ For Claude Desktop, Goose, Codex, Amp, and other clients, see [CONFIGURATION.md](CONFIGURATION.md) for detailed setup instructions.
40
+
41
+ </details>
42
+
43
+ ---
4
44
 
5
45
  An MCP server that provides:
6
46
  1. **Universal LLM Access** - Call any LLM (Claude, GPT, Gemini, Bedrock, Azure, local models) through LiteLLM
@@ -172,129 +212,9 @@ Message 2: Continue → Progress: 60% → {{continuation: registry://plan/001}}
172
212
  Message 3: Continue → Complete! Here's your report...
173
213
  ```
174
214
 
175
- ## Quick Start
176
-
177
- ### Prerequisites
178
-
179
- - **Node.js 14+** (for npm/npx)
180
- - **Python 3.11+** (automatically detected)
181
- - **Claude Desktop** (or any MCP-compatible client)
182
- - **At least one LLM API key** (see below)
183
-
184
- **Optional but recommended:**
185
- - **uv** package manager ([installation guide](https://docs.astral.sh/uv/getting-started/installation/)) - for better dependency management
186
-
187
- ### Step 1: Get API Keys
188
-
189
- You need at least one LLM API key to use UER. We recommend starting with **Google Gemini** as it offers a free tier:
190
-
191
- #### Google Gemini (Free - Recommended for Testing)
192
-
193
- 1. Visit [https://aistudio.google.com/apikey](https://aistudio.google.com/apikey)
194
- 2. Click "Create API Key"
195
- 3. Copy your key (starts with `AIza...`)
196
- 4. Free tier includes: 10-15 requests/minute, 250K tokens/minute, 250-1000 requests/day (varies by model)
197
-
198
- #### Other Providers (Optional)
199
-
200
- | Provider | Get API Key | Free Tier |
201
- |----------|-------------|-----------|
202
- | **Anthropic** (Claude) | [console.anthropic.com](https://console.anthropic.com/) | $5 credit for new users |
203
- | **OpenAI** (GPT) | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) | $5 credit for new users |
204
- | **Azure OpenAI** | [Azure Portal](https://portal.azure.com/) | Requires Azure subscription |
205
- | **AWS Bedrock** | [AWS Console](https://console.aws.amazon.com/bedrock/) | Pay-as-you-go |
206
-
207
- ### Step 2: Installation
208
-
209
- **Option A: Using npx (Recommended - Zero Installation)**
210
-
211
- No installation needed! Just configure Claude Desktop (Step 3) and it will automatically download and run the latest version.
212
-
213
- **Option B: Manual Installation (For Development)**
214
-
215
- ```bash
216
- # Clone the repository
217
- git clone https://github.com/margusmartsepp/UER.git
218
- cd UER
219
-
220
- # Install dependencies
221
- uv sync
222
-
223
- # Build the npm package
224
- npm run build
225
- ```
226
-
227
- ### Step 3: Configure Claude Desktop
228
-
229
- Add UER as an MCP server to Claude Desktop:
230
-
231
- **Location:** `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)
232
-
233
- **Minimal Configuration (Gemini only - Using npx):**
234
- ```json
235
- {
236
- "mcpServers": {
237
- "uer": {
238
- "command": "npx",
239
- "args": ["uer-mcp@latest"],
240
- "env": {
241
- "GEMINI_API_KEY": "AIza_your_key_here"
242
- }
243
- }
244
- }
245
- }
246
- ```
247
-
248
- **Full Configuration (All providers - Using npx):**
249
- ```json
250
- {
251
- "mcpServers": {
252
- "uer": {
253
- "command": "npx",
254
- "args": ["uer-mcp@latest"],
255
- "env": {
256
- "GEMINI_API_KEY": "AIza_your_key_here",
257
- "ANTHROPIC_API_KEY": "sk-ant-...",
258
- "OPENAI_API_KEY": "sk-...",
259
- "AWS_ACCESS_KEY_ID": "...",
260
- "AWS_SECRET_ACCESS_KEY": "...",
261
- "AWS_REGION_NAME": "us-east-1",
262
- "AZURE_API_KEY": "...",
263
- "AZURE_API_BASE": "https://....openai.azure.com/"
264
- }
265
- }
266
- }
267
- }
268
- ```
269
-
270
- **Manual Installation Configuration (For Development):**
271
- ```json
272
- {
273
- "mcpServers": {
274
- "uer": {
275
- "command": "uv",
276
- "args": ["--directory", "C:\\path\\to\\UER", "run", "python", "-m", "uer.server"],
277
- "env": {
278
- "GEMINI_API_KEY": "AIza_your_key_here"
279
- }
280
- }
281
- }
282
- }
283
- ```
284
-
285
- **Important:**
286
- - For npx: No path needed, just add your API keys
287
- - For manual install: Replace `C:\\path\\to\\UER` with your actual directory
288
- - Use double backslashes `\\` on Windows, or forward slashes `/` on Mac/Linux
289
- - Only include API keys for providers you want to use
290
-
291
- ### Step 4: Restart Claude Desktop
292
-
293
- 1. Quit Claude Desktop completely
294
- 2. Reopen Claude Desktop
295
- 3. Look for the 🔨 (hammer) icon indicating MCP tools are loaded
215
+ ## Usage
296
216
 
297
- ### Step 5: Test Your Setup
217
+ ### Test Your Setup
298
218
 
299
219
  Try this in Claude Desktop:
300
220