@toolsdk.ai/registry 1.0.128 → 1.0.130
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 -105
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,107 +1,52 @@
|
|
|
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.npmjs.com/package/@toolsdk.ai/registry">
|
|
11
|
+
<img src="https://img.shields.io/npm/v/@toolsdk.ai/registry.svg?style=flat-square" alt="npm version" />
|
|
12
|
+
</a>
|
|
13
|
+
<a href="https://github.com/toolsdk-ai/toolsdk-mcp-registry/actions/workflows/test.yaml">
|
|
14
|
+
<img src="https://github.com/toolsdk-ai/toolsdk-mcp-registry/actions/workflows/test.yaml/badge.svg" alt="Build Status" />
|
|
15
|
+
</a>
|
|
16
|
+
<img src="https://img.shields.io/badge/MCP_Servers-4109-blue?style=flat-square" alt="MCP Servers Count" />
|
|
17
|
+
<img src="https://img.shields.io/badge/LICENSE-MIT-ff69b4?style=flat-square" alt="License" />
|
|
18
|
+
</p>
|
|
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
|
+
<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
|
+
•
|
|
43
|
+
<a href="#submit-new-mcp-servers">➕ <b>Add Server</b></a>
|
|
44
|
+
</p>
|
|
15
45
|
|
|
16
46
|
---
|
|
17
47
|
|
|
18
48
|
</div>
|
|
19
49
|
|
|
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
50
|
<a id="quick-start"></a>
|
|
106
51
|
|
|
107
52
|
## 🚀 Quick Start
|
|
@@ -112,29 +57,32 @@ Deploy your own **private MCP registry** in 5 minutes! Get a production-ready AI
|
|
|
112
57
|
|
|
113
58
|
Perfect for **AI developers**, **LLM teams**, and **enterprises** building with Claude, Anthropic, and other AI platforms.
|
|
114
59
|
|
|
115
|
-
#### ⚡ Quick Deploy (
|
|
116
|
-
|
|
117
|
-
**Step 1: Configure Sandbox Environment**
|
|
118
|
-
|
|
119
|
-
- Get your Sandock API Key from https://sandock.ai (for secure remote code execution)
|
|
120
|
-
- Edit `.env` and set: `SANDOCK_API_KEY=your-api-key-here`
|
|
60
|
+
#### ⚡ Quick Deploy (One-Liner)
|
|
121
61
|
|
|
122
|
-
|
|
62
|
+
Start the registry immediately with default settings:
|
|
123
63
|
|
|
124
64
|
```bash
|
|
125
65
|
docker compose up -d
|
|
126
66
|
```
|
|
127
67
|
|
|
68
|
+
**Optional Configuration:**
|
|
69
|
+
- Create a `.env` file if you need secure remote execution (Sandock) or want to disable the sandbox (`MCP_SANDBOX_PROVIDER=LOCAL`).
|
|
70
|
+
- *See [Configuration Guide](./docs/DEVELOPMENT.md) for full details.*
|
|
71
|
+
|
|
72
|
+
> 💡 **Tip for Private Deployment**:
|
|
73
|
+
> This registry contains 4109+ public MCP servers. If you only need a specific subset for your private environment, you can prune the `packages/` directory.
|
|
74
|
+
> 📖 See [Package Management Guide](./docs/DEVELOPMENT.md#5--package-management-for-private-deployment) for details.
|
|
75
|
+
|
|
128
76
|
That's it! Your self-hosted MCP registry is now running with:
|
|
129
77
|
- 🔍 **Full-text search** (Meilisearch)
|
|
130
78
|
- 🌐 **REST API** with OpenAPI documentation
|
|
131
79
|
- 🛡️ **Sandbox execution** for AI agent tools
|
|
132
80
|
|
|
133
|
-
#### 🎉 Access Your Private
|
|
81
|
+
#### 🎉 Access Your Private MCP Registry
|
|
134
82
|
|
|
135
|
-
- 🌐 **Web Interface**: http://localhost:3003
|
|
83
|
+
- 🌐 **Local Web Interface**: http://localhost:3003
|
|
136
84
|
- 📚 **Swagger API Docs**: http://localhost:3003/swagger
|
|
137
|
-
- 🔍 **Search & Execute** 4109+ MCP
|
|
85
|
+
- 🔍 **Search & Execute** 4109+ MCP Servers remotely
|
|
138
86
|
- 🤖 **Integrate** with your AI agents, chatbots, and LLM applications
|
|
139
87
|
|
|
140
88
|
#### 💻 Remote Tool Execution Example
|
|
@@ -177,7 +125,7 @@ npm install @toolsdk.ai/registry
|
|
|
177
125
|
Perfect for AI agent development, chatbot builders, and LLM tool integrations:
|
|
178
126
|
|
|
179
127
|
```ts
|
|
180
|
-
import mcpServerLists from '@toolsdk.ai/registry/indexes/packages-
|
|
128
|
+
import mcpServerLists from '@toolsdk.ai/registry/indexes/packages-list.json';
|
|
181
129
|
```
|
|
182
130
|
|
|
183
131
|
#### 🌐 Access via Public API (No Installation Required)
|
|
@@ -209,6 +157,121 @@ mcp_servers = requests.get(
|
|
|
209
157
|
# Perfect for LangChain, CrewAI, AutoGen integrations
|
|
210
158
|
```
|
|
211
159
|
|
|
160
|
+
---
|
|
161
|
+
|
|
162
|
+
## 🌟 Why ToolSDK MCP Registry?
|
|
163
|
+
|
|
164
|
+
**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.
|
|
165
|
+
|
|
166
|
+
### 🎯 Key Features
|
|
167
|
+
|
|
168
|
+
- 🔐 **Private & Self-Hosted** - Deploy your own secure MCP registry with Docker in minutes
|
|
169
|
+
- 🤖 **4109+ MCP Servers** - Largest curated collection of MCP servers
|
|
170
|
+
- ⚡ **Remote Execution** - Run MCP tools in isolated sandbox environments via REST API
|
|
171
|
+
- 🔍 **Powerful Search** - Fast, full-text search powered by Meilisearch
|
|
172
|
+
- 📦 **NPM Integration** - Use as a TypeScript/Node.js SDK in your projects
|
|
173
|
+
- 🛠️ **Developer-Friendly** - OpenAPI/Swagger documentation, structured JSON configs
|
|
174
|
+
- 🐳 **Docker Ready** - Production-grade deployment with Docker Compose
|
|
175
|
+
- 🔌 **Extensible Architecture** - Easily add new MCP servers via JSON config
|
|
176
|
+
|
|
177
|
+
### 💡 Use Cases
|
|
178
|
+
|
|
179
|
+
- 🏢 **Enterprise AI Teams** - "Allow LLMs to query your private PostgreSQL database securely."
|
|
180
|
+
- 🤖 **AI Agent Development** - "Ask Claude to verify PRs via GitHub MCP and deploy to Kubernetes."
|
|
181
|
+
- 💬 **Chatbot Builders** - Integrate LLM-powered chatbots with 4000+ ready-to-use MCP servers.
|
|
182
|
+
- 🔧 **DevOps Automation** - Execute MCP tools in your CI/CD pipelines for automated testing and deployment.
|
|
183
|
+
- 🚀 **Data Analysis** - Connect AI agents to internal data sources (Snowflake, Databricks) without building custom integrations.
|
|
184
|
+
|
|
185
|
+
### 🏗️ Architecture
|
|
186
|
+
|
|
187
|
+
```mermaid
|
|
188
|
+
graph TD
|
|
189
|
+
subgraph "Client Side"
|
|
190
|
+
User["👤 User / Developer"]
|
|
191
|
+
LLM["🤖 AI Agent / LLM"]
|
|
192
|
+
end
|
|
193
|
+
|
|
194
|
+
subgraph "ToolSDK MCP Registry (Docker)"
|
|
195
|
+
API["🌐 Registry API (Hono.js)"]
|
|
196
|
+
Search["🔍 Meilisearch Engine"]
|
|
197
|
+
DB["📚 JSON Registry Data"]
|
|
198
|
+
end
|
|
199
|
+
|
|
200
|
+
subgraph "Execution Environment"
|
|
201
|
+
Sandbox["🛡️ Secure Sandbox (Sandock/Daytona/E2B/Local)"]
|
|
202
|
+
MCPServer["⚙️ MCP Server"]
|
|
203
|
+
end
|
|
204
|
+
|
|
205
|
+
User -->|Search Tools| API
|
|
206
|
+
LLM -->|Execute Tool via REST| API
|
|
207
|
+
API <-->|Query Index| Search
|
|
208
|
+
API -->|Read Metadata| DB
|
|
209
|
+
API -->|Run Tool| Sandbox
|
|
210
|
+
Sandbox -->|Execute| MCPServer
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
---
|
|
214
|
+
|
|
215
|
+
## 📦 What You Get
|
|
216
|
+
|
|
217
|
+
This open-source registry provides:
|
|
218
|
+
|
|
219
|
+
- 📚 **Structured Registry** - 4109+ validated MCP servers with metadata
|
|
220
|
+
- 🔗 **Multiple Formats** - JSON, npm package, and generated documentation
|
|
221
|
+
- 🌐 **REST API** - Query and execute tools remotely
|
|
222
|
+
- 📖 **Auto-Generated Docs** - Always up-to-date README and API documentation
|
|
223
|
+
|
|
224
|
+
**Available as:**
|
|
225
|
+
|
|
226
|
+
- 📄 `README.md` - Human-readable documentation
|
|
227
|
+
- 📦 [npm package](https://www.npmjs.com/package/@toolsdk.ai/registry) - TypeScript/JavaScript SDK
|
|
228
|
+
- 🔗 [packages-list.json](https://toolsdk-ai.github.io/toolsdk-mcp-registry/indexes/packages-list.json) - Raw data API
|
|
229
|
+
|
|
230
|
+
---
|
|
231
|
+
|
|
232
|
+
## 📚 Table of Contents
|
|
233
|
+
|
|
234
|
+
- [🎥 Video: How to add a new MCP server](https://www.youtube.com/watch?v=J_oaDtCoVVo)
|
|
235
|
+
- [🚀 Quick Start](#quick-start)
|
|
236
|
+
- [🐳 Docker Self-Hosting](#-docker-self-hosting)
|
|
237
|
+
- [📦 Install via Package Manager](#install-via-package-manager)
|
|
238
|
+
- [📄 Submit New MCP Servers](#submit-new-mcp-servers)
|
|
239
|
+
- [📖 Development Guide](./docs/DEVELOPMENT.md)
|
|
240
|
+
- [🤝 Contributing Guide](./docs/guide.md)
|
|
241
|
+
- [⭐ ToolSDK MCP Servers](#mcp-servers)
|
|
242
|
+
|
|
243
|
+
- [Uncategorized](#uncategorized)
|
|
244
|
+
- [Aggregators](#aggregators)
|
|
245
|
+
- [Art & Culture](#art-and-culture)
|
|
246
|
+
- [Browser Automation](#browser-automation)
|
|
247
|
+
- [Cloud Platforms](#cloud-platforms)
|
|
248
|
+
- [Code Execution](#code-execution)
|
|
249
|
+
- [Coding Agents](#coding-agents)
|
|
250
|
+
- [Command Line](#command-line)
|
|
251
|
+
- [Communication](#communication)
|
|
252
|
+
- [Customer Data Platforms](#customer-data-platforms)
|
|
253
|
+
- [Databases](#databases)
|
|
254
|
+
- [Data Platforms](#data-platforms)
|
|
255
|
+
- [Developer Tools](#developer-tools)
|
|
256
|
+
- [Data Science Tools](#data-science-tools)
|
|
257
|
+
- [Embedded System](#embedded-system)
|
|
258
|
+
- [File Systems](#file-systems)
|
|
259
|
+
- [Finance & Fintech](#finance-fintech)
|
|
260
|
+
- [Gaming](#gaming)
|
|
261
|
+
- [Knowledge & Memory](#knowledge-memory)
|
|
262
|
+
- [Location Services](#location-services)
|
|
263
|
+
- [Marketing](#marketing)
|
|
264
|
+
- [Monitoring](#monitoring)
|
|
265
|
+
- [Search & Data Extraction](#search-data-extraction)
|
|
266
|
+
- [Security](#security)
|
|
267
|
+
- [Sports](#sports)
|
|
268
|
+
- [Support & Service Management](#support-service-management)
|
|
269
|
+
- [Translation Services](#translation-services)
|
|
270
|
+
- [Travel & Transportation](#travel-transportation)
|
|
271
|
+
- [Version Control](#version-control)
|
|
272
|
+
- [Other Tools and Integrations](#other-tools-and-integrations)
|
|
273
|
+
|
|
274
|
+
|
|
212
275
|
<a id="submit-new-mcp-servers"></a>
|
|
213
276
|
|
|
214
277
|
## 🤝 Contribute Your MCP Server
|
|
@@ -249,7 +312,7 @@ Your MCP server will be:
|
|
|
249
312
|
- ✅ Listed in the registry
|
|
250
313
|
- 🔍 Searchable via REST API
|
|
251
314
|
- 📦 Available in npm package
|
|
252
|
-
- 🌐 Featured on
|
|
315
|
+
- 🌐 Featured on [ToolSDK.ai](https://toolsdk.ai)
|
|
253
316
|
|
|
254
317
|
📖 **Detailed Guide**: [Contributing Documentation](./docs/guide.md)
|
|
255
318
|
|