@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.
Files changed (2) hide show
  1. package/README.md +36 -31
  2. 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
  &nbsp;&nbsp;•&nbsp;&nbsp;
41
41
  <a href="#install-via-package-manager">📦 <b>Use as SDK</b></a>
42
+ &nbsp;&nbsp;•&nbsp;&nbsp;
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 (2 Steps)
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
- **Step 2: Launch with Docker Compose**
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 "ToolSDK MCP Registry (Docker)"
199
- API["🌐 Registry API (Hono.js)"]
200
- Search["🔍 Meilisearch Engine"]
201
- DB["📚 JSON Registry Data"]
202
- end
203
-
204
- subgraph "Execution Environment"
205
- Sandbox["🛡️ Secure Sandbox (Sandock/Daytona/E2B/Local)"]
206
- MCPServer["⚙️ MCP Server"]
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 via REST| API
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](#-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)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@toolsdk.ai/registry",
3
- "version": "1.0.129",
3
+ "version": "1.0.131",
4
4
  "description": "An Open, Structured, and Standard Registry for MCP Servers and Packages.",
5
5
  "keywords": [
6
6
  "mcp",