@toolsdk.ai/registry 1.0.128 → 1.0.129
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 +168 -101
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,107 +1,50 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
+
<img src="docs/logo.png" width="120" alt="ToolSDK MCP Registry" />
|
|
4
|
+
|
|
3
5
|
# ToolSDK MCP Registry
|
|
4
6
|
|
|
5
7
|
**Your private, secure, and customizable MCP Registry — take full control of your tools.**
|
|
6
8
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
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
|
+
<p align="center">
|
|
16
|
+
<a href="https://www.npmjs.com/package/@toolsdk.ai/registry">
|
|
17
|
+
<img src="https://img.shields.io/npm/v/@toolsdk.ai/registry.svg?style=flat-square" alt="npm version" />
|
|
18
|
+
</a>
|
|
19
|
+
<a href="https://github.com/toolsdk-ai/toolsdk-mcp-registry/actions/workflows/test.yaml">
|
|
20
|
+
<img src="https://github.com/toolsdk-ai/toolsdk-mcp-registry/actions/workflows/test.yaml/badge.svg" alt="Build Status" />
|
|
21
|
+
</a>
|
|
22
|
+
<img src="https://img.shields.io/badge/MCP_Servers-4109-blue?style=flat-square" alt="MCP Servers Count" />
|
|
23
|
+
<img src="https://img.shields.io/badge/LICENSE-MIT-ff69b4?style=flat-square" alt="License" />
|
|
24
|
+
</p>
|
|
25
|
+
|
|
26
|
+
<p align="center">
|
|
27
|
+
🚀 <b>Open-source</b>, <b>production-ready</b>, and <b>developer-friendly</b> registry for 4109+ Model Context Protocol (MCP) servers.
|
|
28
|
+
<br />
|
|
29
|
+
<i>Perfect for <b>AI automation</b>, <b>chatbot development</b>, <b>LLM integrations</b>, and <b>enterprise AI deployments</b>.</i>
|
|
30
|
+
</p>
|
|
31
|
+
|
|
32
|
+
<p align="center">
|
|
33
|
+
<strong>The Universal MCP Hub: A comprehensive directory for discovery AND a private engine for enterprise.</strong>
|
|
34
|
+
</p>
|
|
35
|
+
|
|
36
|
+
<p align="center">
|
|
37
|
+
<a href="#mcp-servers">🔍 <b>Browse 4109+ Tools</b></a>
|
|
38
|
+
•
|
|
39
|
+
<a href="#quick-start">🐳 <b>Deploy Private Registry</b></a>
|
|
40
|
+
•
|
|
41
|
+
<a href="#install-via-package-manager">📦 <b>Use as SDK</b></a>
|
|
42
|
+
</p>
|
|
15
43
|
|
|
16
44
|
---
|
|
17
45
|
|
|
18
46
|
</div>
|
|
19
47
|
|
|
20
|
-
## 🌟 Why ToolSDK MCP Registry?
|
|
21
|
-
|
|
22
|
-
**ToolSDK MCP Registry** is the most comprehensive, self-hosted registry for Model Context Protocol (MCP) servers and AI agent tools. Built for developers, teams, and enterprises who need full control over their AI infrastructure.
|
|
23
|
-
|
|
24
|
-
### 🎯 Key Features
|
|
25
|
-
|
|
26
|
-
- 🔐 **Private & Self-Hosted** - Deploy your own secure MCP registry with Docker in minutes
|
|
27
|
-
- 🤖 **4109+ AI Tools** - Largest curated collection of MCP servers for Claude, LLMs, and AI agents
|
|
28
|
-
- ⚡ **Remote Execution** - Run MCP tools in isolated sandbox environments via REST API
|
|
29
|
-
- 🔍 **Powerful Search** - Fast, full-text search powered by Meilisearch
|
|
30
|
-
- 📦 **NPM Integration** - Use as a TypeScript/Node.js SDK in your projects
|
|
31
|
-
- 🛠️ **Developer-Friendly** - OpenAPI/Swagger documentation, structured JSON configs
|
|
32
|
-
- 🐳 **Docker Ready** - Production-grade deployment with Docker Compose
|
|
33
|
-
- 🔌 **Plugin System** - Extensible architecture for custom integrations
|
|
34
|
-
|
|
35
|
-
### 💡 Use Cases
|
|
36
|
-
|
|
37
|
-
- 🏢 **Enterprise AI Teams** - Deploy private MCP registry for your organization
|
|
38
|
-
- 🤖 **AI Agent Development** - Build and test AI agents with verified MCP tools
|
|
39
|
-
- 💬 **Chatbot Builders** - Integrate LLM-powered chatbots with MCP servers
|
|
40
|
-
- 🔧 **Developer Tools** - Access automation tools, APIs, and integrations
|
|
41
|
-
- 🚀 **CI/CD Automation** - Execute MCP tools in your deployment pipelines
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
## 📦 What You Get
|
|
46
|
-
|
|
47
|
-
This open-source registry provides:
|
|
48
|
-
|
|
49
|
-
- 📚 **Structured Database** - 4109+ validated MCP servers with metadata
|
|
50
|
-
- 🔗 **Multiple Formats** - JSON, npm package, and generated documentation
|
|
51
|
-
- 🌐 **REST API** - Query and execute tools remotely
|
|
52
|
-
- 📖 **Auto-Generated Docs** - Always up-to-date README and API documentation
|
|
53
|
-
|
|
54
|
-
**Available as:**
|
|
55
|
-
|
|
56
|
-
- 📄 `README.md` - Human-readable documentation
|
|
57
|
-
- 📦 [npm package](https://www.npmjs.com/package/@toolsdk.ai/registry) - TypeScript/JavaScript SDK
|
|
58
|
-
- 🔗 [packages-list.json](https://toolsdk-ai.github.io/toolsdk-mcp-registry/indexes/packages-list.json) - Raw data API
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
62
|
-
## 📚 Table of Contents
|
|
63
|
-
|
|
64
|
-
- [🎥 Video: How to submit a MCP server in JSON file?](https://www.youtube.com/watch?v=J_oaDtCoVVo)
|
|
65
|
-
- [🚀 Quick Start](#quick-start)
|
|
66
|
-
- [🐳 Docker Self-Hosting](#-docker-self-hosting)
|
|
67
|
-
- [📦 Install via Package Manager](#install-via-package-manager)
|
|
68
|
-
- [📄 Submit New MCP Servers](#submit-new-mcp-servers)
|
|
69
|
-
- [📖 Development Guide](./docs/DEVELOPMENT.md)
|
|
70
|
-
- [🤝 Contributing Guide](./docs/guide.md)
|
|
71
|
-
- [⭐ ToolSDK MCP Servers](#mcp-servers)
|
|
72
|
-
|
|
73
|
-
- [Uncategorized](#uncategorized)
|
|
74
|
-
- [Aggregators](#aggregators)
|
|
75
|
-
- [Art & Culture](#art-and-culture)
|
|
76
|
-
- [Browser Automation](#browser-automation)
|
|
77
|
-
- [Cloud Platforms](#cloud-platforms)
|
|
78
|
-
- [Code Execution](#code-execution)
|
|
79
|
-
- [Coding Agents](#coding-agents)
|
|
80
|
-
- [Command Line](#command-line)
|
|
81
|
-
- [Communication](#communication)
|
|
82
|
-
- [Customer Data Platforms](#customer-data-platforms)
|
|
83
|
-
- [Databases](#databases)
|
|
84
|
-
- [Data Platforms](#data-platforms)
|
|
85
|
-
- [Developer Tools](#developer-tools)
|
|
86
|
-
- [Data Science Tools](#data-science-tools)
|
|
87
|
-
- [Embedded System](#embedded-system)
|
|
88
|
-
- [File Systems](#file-systems)
|
|
89
|
-
- [Finance & Fintech](#finance-fintech)
|
|
90
|
-
- [Gaming](#gaming)
|
|
91
|
-
- [Knowledge & Memory](#knowledge-memory)
|
|
92
|
-
- [Location Services](#location-services)
|
|
93
|
-
- [Marketing](#marketing)
|
|
94
|
-
- [Monitoring](#monitoring)
|
|
95
|
-
- [Search & Data Extraction](#search-data-extraction)
|
|
96
|
-
- [Security](#security)
|
|
97
|
-
- [Sports](#sports)
|
|
98
|
-
- [Support & Service Management](#support-service-management)
|
|
99
|
-
- [Translation Services](#translation-services)
|
|
100
|
-
- [Travel & Transportation](#travel-transportation)
|
|
101
|
-
- [Version Control](#version-control)
|
|
102
|
-
- [Other Tools and Integrations](#other-tools-and-integrations)
|
|
103
|
-
|
|
104
|
-
|
|
105
48
|
<a id="quick-start"></a>
|
|
106
49
|
|
|
107
50
|
## 🚀 Quick Start
|
|
@@ -114,10 +57,15 @@ Perfect for **AI developers**, **LLM teams**, and **enterprises** building with
|
|
|
114
57
|
|
|
115
58
|
#### ⚡ Quick Deploy (2 Steps)
|
|
116
59
|
|
|
117
|
-
**
|
|
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**
|
|
118
65
|
|
|
119
|
-
-
|
|
120
|
-
-
|
|
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`.*
|
|
121
69
|
|
|
122
70
|
**Step 2: Launch with Docker Compose**
|
|
123
71
|
|
|
@@ -125,16 +73,20 @@ Perfect for **AI developers**, **LLM teams**, and **enterprises** building with
|
|
|
125
73
|
docker compose up -d
|
|
126
74
|
```
|
|
127
75
|
|
|
76
|
+
> 💡 **Tip for Private Deployment**:
|
|
77
|
+
> 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
|
+
> 📖 See [Package Management Guide](./docs/DEVELOPMENT.md#5--package-management-for-private-deployment) for details.
|
|
79
|
+
|
|
128
80
|
That's it! Your self-hosted MCP registry is now running with:
|
|
129
81
|
- 🔍 **Full-text search** (Meilisearch)
|
|
130
82
|
- 🌐 **REST API** with OpenAPI documentation
|
|
131
83
|
- 🛡️ **Sandbox execution** for AI agent tools
|
|
132
84
|
|
|
133
|
-
#### 🎉 Access Your Private
|
|
85
|
+
#### 🎉 Access Your Private MCP Registry
|
|
134
86
|
|
|
135
|
-
- 🌐 **Web Interface**: http://localhost:3003
|
|
87
|
+
- 🌐 **Local Web Interface**: http://localhost:3003
|
|
136
88
|
- 📚 **Swagger API Docs**: http://localhost:3003/swagger
|
|
137
|
-
- 🔍 **Search & Execute** 4109+ MCP
|
|
89
|
+
- 🔍 **Search & Execute** 4109+ MCP Servers remotely
|
|
138
90
|
- 🤖 **Integrate** with your AI agents, chatbots, and LLM applications
|
|
139
91
|
|
|
140
92
|
#### 💻 Remote Tool Execution Example
|
|
@@ -177,7 +129,7 @@ npm install @toolsdk.ai/registry
|
|
|
177
129
|
Perfect for AI agent development, chatbot builders, and LLM tool integrations:
|
|
178
130
|
|
|
179
131
|
```ts
|
|
180
|
-
import mcpServerLists from '@toolsdk.ai/registry/indexes/packages-
|
|
132
|
+
import mcpServerLists from '@toolsdk.ai/registry/indexes/packages-list.json';
|
|
181
133
|
```
|
|
182
134
|
|
|
183
135
|
#### 🌐 Access via Public API (No Installation Required)
|
|
@@ -209,6 +161,121 @@ mcp_servers = requests.get(
|
|
|
209
161
|
# Perfect for LangChain, CrewAI, AutoGen integrations
|
|
210
162
|
```
|
|
211
163
|
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## 🌟 Why ToolSDK MCP Registry?
|
|
167
|
+
|
|
168
|
+
**ToolSDK MCP Registry** is the most comprehensive, self-hosted registry for Model Context Protocol (MCP) servers and AI agent tools. Built for developers, teams, and enterprises who need full control over their AI infrastructure.
|
|
169
|
+
|
|
170
|
+
### 🎯 Key Features
|
|
171
|
+
|
|
172
|
+
- 🔐 **Private & Self-Hosted** - Deploy your own secure MCP registry with Docker in minutes
|
|
173
|
+
- 🤖 **4109+ MCP Servers** - Largest curated collection of MCP servers
|
|
174
|
+
- ⚡ **Remote Execution** - Run MCP tools in isolated sandbox environments via REST API
|
|
175
|
+
- 🔍 **Powerful Search** - Fast, full-text search powered by Meilisearch
|
|
176
|
+
- 📦 **NPM Integration** - Use as a TypeScript/Node.js SDK in your projects
|
|
177
|
+
- 🛠️ **Developer-Friendly** - OpenAPI/Swagger documentation, structured JSON configs
|
|
178
|
+
- 🐳 **Docker Ready** - Production-grade deployment with Docker Compose
|
|
179
|
+
- 🔌 **Extensible Architecture** - Easily add new MCP servers via JSON config
|
|
180
|
+
|
|
181
|
+
### 💡 Use Cases
|
|
182
|
+
|
|
183
|
+
- 🏢 **Enterprise AI Teams** - "Allow LLMs to query your private PostgreSQL database securely."
|
|
184
|
+
- 🤖 **AI Agent Development** - "Ask Claude to verify PRs via GitHub MCP and deploy to Kubernetes."
|
|
185
|
+
- 💬 **Chatbot Builders** - Integrate LLM-powered chatbots with 4000+ ready-to-use MCP servers.
|
|
186
|
+
- 🔧 **DevOps Automation** - Execute MCP tools in your CI/CD pipelines for automated testing and deployment.
|
|
187
|
+
- 🚀 **Data Analysis** - Connect AI agents to internal data sources (Snowflake, Databricks) without building custom integrations.
|
|
188
|
+
|
|
189
|
+
### 🏗️ Architecture
|
|
190
|
+
|
|
191
|
+
```mermaid
|
|
192
|
+
graph TD
|
|
193
|
+
subgraph "Client Side"
|
|
194
|
+
User["👤 User / Developer"]
|
|
195
|
+
LLM["🤖 AI Agent / LLM"]
|
|
196
|
+
end
|
|
197
|
+
|
|
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"]
|
|
207
|
+
end
|
|
208
|
+
|
|
209
|
+
User -->|Search Tools| API
|
|
210
|
+
LLM -->|Execute Tool via REST| API
|
|
211
|
+
API <-->|Query Index| Search
|
|
212
|
+
API -->|Read Metadata| DB
|
|
213
|
+
API -->|Run Tool| Sandbox
|
|
214
|
+
Sandbox -->|Execute| MCPServer
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
## 📦 What You Get
|
|
220
|
+
|
|
221
|
+
This open-source registry provides:
|
|
222
|
+
|
|
223
|
+
- 📚 **Structured Registry** - 4109+ validated MCP servers with metadata
|
|
224
|
+
- 🔗 **Multiple Formats** - JSON, npm package, and generated documentation
|
|
225
|
+
- 🌐 **REST API** - Query and execute tools remotely
|
|
226
|
+
- 📖 **Auto-Generated Docs** - Always up-to-date README and API documentation
|
|
227
|
+
|
|
228
|
+
**Available as:**
|
|
229
|
+
|
|
230
|
+
- 📄 `README.md` - Human-readable documentation
|
|
231
|
+
- 📦 [npm package](https://www.npmjs.com/package/@toolsdk.ai/registry) - TypeScript/JavaScript SDK
|
|
232
|
+
- 🔗 [packages-list.json](https://toolsdk-ai.github.io/toolsdk-mcp-registry/indexes/packages-list.json) - Raw data API
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
## 📚 Table of Contents
|
|
237
|
+
|
|
238
|
+
- [🎥 Video: How to add a new MCP server](https://www.youtube.com/watch?v=J_oaDtCoVVo)
|
|
239
|
+
- [🚀 Quick Start](#quick-start)
|
|
240
|
+
- [🐳 Docker Self-Hosting](#-docker-self-hosting)
|
|
241
|
+
- [📦 Install via Package Manager](#install-via-package-manager)
|
|
242
|
+
- [📄 Submit New MCP Servers](#submit-new-mcp-servers)
|
|
243
|
+
- [📖 Development Guide](./docs/DEVELOPMENT.md)
|
|
244
|
+
- [🤝 Contributing Guide](./docs/guide.md)
|
|
245
|
+
- [⭐ ToolSDK MCP Servers](#mcp-servers)
|
|
246
|
+
|
|
247
|
+
- [Uncategorized](#uncategorized)
|
|
248
|
+
- [Aggregators](#aggregators)
|
|
249
|
+
- [Art & Culture](#art-and-culture)
|
|
250
|
+
- [Browser Automation](#browser-automation)
|
|
251
|
+
- [Cloud Platforms](#cloud-platforms)
|
|
252
|
+
- [Code Execution](#code-execution)
|
|
253
|
+
- [Coding Agents](#coding-agents)
|
|
254
|
+
- [Command Line](#command-line)
|
|
255
|
+
- [Communication](#communication)
|
|
256
|
+
- [Customer Data Platforms](#customer-data-platforms)
|
|
257
|
+
- [Databases](#databases)
|
|
258
|
+
- [Data Platforms](#data-platforms)
|
|
259
|
+
- [Developer Tools](#developer-tools)
|
|
260
|
+
- [Data Science Tools](#data-science-tools)
|
|
261
|
+
- [Embedded System](#embedded-system)
|
|
262
|
+
- [File Systems](#file-systems)
|
|
263
|
+
- [Finance & Fintech](#finance-fintech)
|
|
264
|
+
- [Gaming](#gaming)
|
|
265
|
+
- [Knowledge & Memory](#knowledge-memory)
|
|
266
|
+
- [Location Services](#location-services)
|
|
267
|
+
- [Marketing](#marketing)
|
|
268
|
+
- [Monitoring](#monitoring)
|
|
269
|
+
- [Search & Data Extraction](#search-data-extraction)
|
|
270
|
+
- [Security](#security)
|
|
271
|
+
- [Sports](#sports)
|
|
272
|
+
- [Support & Service Management](#support-service-management)
|
|
273
|
+
- [Translation Services](#translation-services)
|
|
274
|
+
- [Travel & Transportation](#travel-transportation)
|
|
275
|
+
- [Version Control](#version-control)
|
|
276
|
+
- [Other Tools and Integrations](#other-tools-and-integrations)
|
|
277
|
+
|
|
278
|
+
|
|
212
279
|
<a id="submit-new-mcp-servers"></a>
|
|
213
280
|
|
|
214
281
|
## 🤝 Contribute Your MCP Server
|
|
@@ -249,7 +316,7 @@ Your MCP server will be:
|
|
|
249
316
|
- ✅ Listed in the registry
|
|
250
317
|
- 🔍 Searchable via REST API
|
|
251
318
|
- 📦 Available in npm package
|
|
252
|
-
- 🌐 Featured on
|
|
319
|
+
- 🌐 Featured on [ToolSDK.ai](https://toolsdk.ai)
|
|
253
320
|
|
|
254
321
|
📖 **Detailed Guide**: [Contributing Documentation](./docs/guide.md)
|
|
255
322
|
|