@toolsdk.ai/registry 1.0.129 → 1.0.131
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.
- package/README.md +36 -31
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,12 +6,6 @@
|
|
|
6
6
|
|
|
7
7
|
**Your private, secure, and customizable MCP Registry — take full control of your tools.**
|
|
8
8
|
|
|
9
|
-
<p align="center">
|
|
10
|
-
<a href="https://www.producthunt.com/products/toolsdk-ai">
|
|
11
|
-
<img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=997428&theme=light&period=daily" alt="Product Hunt" height="40" />
|
|
12
|
-
</a>
|
|
13
|
-
</p>
|
|
14
|
-
|
|
15
9
|
<p align="center">
|
|
16
10
|
<a href="https://www.npmjs.com/package/@toolsdk.ai/registry">
|
|
17
11
|
<img src="https://img.shields.io/npm/v/@toolsdk.ai/registry.svg?style=flat-square" alt="npm version" />
|
|
@@ -23,6 +17,12 @@
|
|
|
23
17
|
<img src="https://img.shields.io/badge/LICENSE-MIT-ff69b4?style=flat-square" alt="License" />
|
|
24
18
|
</p>
|
|
25
19
|
|
|
20
|
+
<p align="center">
|
|
21
|
+
<a href="https://www.producthunt.com/products/toolsdk-ai">
|
|
22
|
+
<img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=997428&theme=light&period=daily" alt="Product Hunt" height="40" />
|
|
23
|
+
</a>
|
|
24
|
+
</p>
|
|
25
|
+
|
|
26
26
|
<p align="center">
|
|
27
27
|
🚀 <b>Open-source</b>, <b>production-ready</b>, and <b>developer-friendly</b> registry for 4109+ Model Context Protocol (MCP) servers.
|
|
28
28
|
<br />
|
|
@@ -39,6 +39,8 @@
|
|
|
39
39
|
<a href="#quick-start">🐳 <b>Deploy Private Registry</b></a>
|
|
40
40
|
•
|
|
41
41
|
<a href="#install-via-package-manager">📦 <b>Use as SDK</b></a>
|
|
42
|
+
•
|
|
43
|
+
<a href="#submit-new-mcp-servers">➕ <b>Add Server</b></a>
|
|
42
44
|
</p>
|
|
43
45
|
|
|
44
46
|
---
|
|
@@ -49,30 +51,27 @@
|
|
|
49
51
|
|
|
50
52
|
## 🚀 Quick Start
|
|
51
53
|
|
|
54
|
+
<a id="docker-self-hosting"></a>
|
|
55
|
+
|
|
52
56
|
### 🐳 Self-Hosted MCP Registry with Docker
|
|
53
57
|
|
|
54
58
|
Deploy your own **private MCP registry** in 5 minutes! Get a production-ready AI agent tool registry with full-text search, REST API, and secure sandbox execution.
|
|
55
59
|
|
|
56
60
|
Perfect for **AI developers**, **LLM teams**, and **enterprises** building with Claude, Anthropic, and other AI platforms.
|
|
57
61
|
|
|
58
|
-
#### ⚡ Quick Deploy (
|
|
59
|
-
|
|
60
|
-
**Prerequisites:**
|
|
61
|
-
- Docker & Docker Compose
|
|
62
|
-
- (Optional) Sandock API Key - *Required only if you need secure remote execution features.*
|
|
63
|
-
|
|
64
|
-
**Step 1: Configure Environment**
|
|
65
|
-
|
|
66
|
-
- Edit `.env` (optional): `SANDOCK_API_KEY=your-api-key-here`
|
|
67
|
-
- *Note: You can skip this if you only need the Registry and Search features.*
|
|
68
|
-
- *Note: If you do not want to use the sandbox, set `MCP_SANDBOX_PROVIDER=LOCAL` in `.env`.*
|
|
62
|
+
#### ⚡ Quick Deploy (One-Liner)
|
|
69
63
|
|
|
70
|
-
|
|
64
|
+
Start the registry immediately with default settings:
|
|
71
65
|
|
|
72
66
|
```bash
|
|
73
67
|
docker compose up -d
|
|
74
68
|
```
|
|
75
69
|
|
|
70
|
+
**Optional Configuration:**
|
|
71
|
+
- Set `MCP_SANDBOX_PROVIDER=LOCAL` in `.env` file if you want to disable the sandbox.
|
|
72
|
+
- Set `SANDOCK_API_KEY` if you want to use the sandbox for full deployment.
|
|
73
|
+
- *See [Configuration Guide](./docs/DEVELOPMENT.md) for full details.*
|
|
74
|
+
|
|
76
75
|
> 💡 **Tip for Private Deployment**:
|
|
77
76
|
> This registry contains 4109+ public MCP servers. If you only need a specific subset for your private environment, you can prune the `packages/` directory.
|
|
78
77
|
> 📖 See [Package Management Guide](./docs/DEVELOPMENT.md#5--package-management-for-private-deployment) for details.
|
|
@@ -190,27 +189,33 @@ mcp_servers = requests.get(
|
|
|
190
189
|
|
|
191
190
|
```mermaid
|
|
192
191
|
graph TD
|
|
193
|
-
subgraph "Client Side"
|
|
194
|
-
User["👤 User / Developer"]
|
|
192
|
+
subgraph ClientSide ["Client Side"]
|
|
195
193
|
LLM["🤖 AI Agent / LLM"]
|
|
194
|
+
User["👤 User / Developer"]
|
|
196
195
|
end
|
|
197
196
|
|
|
198
|
-
subgraph "
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
197
|
+
subgraph DockerEnv ["🐳 Self-Hosted Infrastructure"]
|
|
198
|
+
|
|
199
|
+
subgraph RegistryCore ["Registry Core"]
|
|
200
|
+
API["🌐 Registry API"]
|
|
201
|
+
Search["🔍 Meilisearch"]
|
|
202
|
+
DB["📚 Registry Data"]
|
|
203
|
+
end
|
|
204
|
+
|
|
205
|
+
subgraph RuntimeEnv ["Runtime Environment"]
|
|
206
|
+
Local["💻 Local Exec"]
|
|
207
|
+
Sandbox["🛡️ Secure Sandbox"]
|
|
208
|
+
MCPServer["⚙️ MCP Server"]
|
|
209
|
+
end
|
|
207
210
|
end
|
|
208
211
|
|
|
209
212
|
User -->|Search Tools| API
|
|
210
|
-
LLM -->|Execute Tool
|
|
213
|
+
LLM -->|Execute Tool| API
|
|
211
214
|
API <-->|Query Index| Search
|
|
212
215
|
API -->|Read Metadata| DB
|
|
216
|
+
API -->|Run Tool| Local
|
|
213
217
|
API -->|Run Tool| Sandbox
|
|
218
|
+
Local -->|Execute| MCPServer
|
|
214
219
|
Sandbox -->|Execute| MCPServer
|
|
215
220
|
```
|
|
216
221
|
|
|
@@ -237,7 +242,7 @@ This open-source registry provides:
|
|
|
237
242
|
|
|
238
243
|
- [🎥 Video: How to add a new MCP server](https://www.youtube.com/watch?v=J_oaDtCoVVo)
|
|
239
244
|
- [🚀 Quick Start](#quick-start)
|
|
240
|
-
- [🐳 Docker Self-Hosting](
|
|
245
|
+
- [🐳 Docker Self-Hosting](#docker-self-hosting)
|
|
241
246
|
- [📦 Install via Package Manager](#install-via-package-manager)
|
|
242
247
|
- [📄 Submit New MCP Servers](#submit-new-mcp-servers)
|
|
243
248
|
- [📖 Development Guide](./docs/DEVELOPMENT.md)
|