@toolsdk.ai/registry 1.0.169 → 1.0.170
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 +23 -37
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -107,6 +107,28 @@ curl -X POST http://localhost:3003/api/v1/packages/run \
|
|
|
107
107
|
}'
|
|
108
108
|
```
|
|
109
109
|
|
|
110
|
+
#### 🔌 MCP Gateway (Streamable HTTP Proxy)
|
|
111
|
+
|
|
112
|
+
The registry also acts as an **MCP Gateway** — any registered package can be accessed as a standard [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) endpoint, even if the original server is STDIO-only.
|
|
113
|
+
|
|
114
|
+
**Endpoint:** `POST /mcp/<packageName>`
|
|
115
|
+
|
|
116
|
+
Pass environment variables via `x-mcp-env-*` headers:
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
curl -X POST http://localhost:3003/mcp/@modelcontextprotocol/server-github \
|
|
120
|
+
-H "Content-Type: application/json" \
|
|
121
|
+
-H "x-mcp-env-GITHUB_PERSONAL_ACCESS_TOKEN: ghp_your_token" \
|
|
122
|
+
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
The server returns a `mcp-session-id` header — include it in subsequent requests to reuse the session (sessions expire after 30 min).
|
|
126
|
+
|
|
127
|
+
This is useful for:
|
|
128
|
+
- **Protocol Bridging** — Expose local STDIO servers as remote HTTP endpoints
|
|
129
|
+
- **Centralized Access** — Give AI agents a single HTTP gateway to all MCP tools
|
|
130
|
+
- **Client Compatibility** — Connect from any MCP client that supports Streamable HTTP
|
|
131
|
+
|
|
110
132
|
<details>
|
|
111
133
|
<summary><strong>Alternative: Use as Registry SDK (Data Only)</strong></summary>
|
|
112
134
|
|
|
@@ -274,46 +296,10 @@ const searchTool = await searchMCP.getAISDKTool('tavily-search');
|
|
|
274
296
|
|
|
275
297
|
## Contribute Your MCP Server
|
|
276
298
|
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
### Quick Submission
|
|
299
|
+
Want to add your MCP server to the registry? Check out our [Contributing Guide](./docs/CONTRIBUTING.md) for the full submission process, JSON schema reference, and examples (including remote servers and OAuth 2.1).
|
|
280
300
|
|
|
281
301
|
[](https://www.youtube.com/watch?v=J_oaDtCoVVo)
|
|
282
302
|
|
|
283
|
-
1. [Fork this repository](https://github.com/toolsdk-ai/toolsdk-mcp-registry/fork)
|
|
284
|
-
2. Create `your-mcp-server.json` in [packages/uncategorized](./packages/uncategorized) (or the best matching category folder)
|
|
285
|
-
3. Submit a PR
|
|
286
|
-
|
|
287
|
-
Config Example:
|
|
288
|
-
|
|
289
|
-
```json
|
|
290
|
-
{
|
|
291
|
-
"type": "mcp-server",
|
|
292
|
-
"name": "Github",
|
|
293
|
-
"packageName": "@modelcontextprotocol/server-github",
|
|
294
|
-
"description": "MCP server for using the GitHub API",
|
|
295
|
-
"url": "https://github.com/modelcontextprotocol/servers/blob/main/src/github",
|
|
296
|
-
"runtime": "node",
|
|
297
|
-
"license": "MIT",
|
|
298
|
-
"env": {
|
|
299
|
-
"GITHUB_PERSONAL_ACCESS_TOKEN": {
|
|
300
|
-
"description": "Personal access token for GitHub API access",
|
|
301
|
-
"required": true
|
|
302
|
-
}
|
|
303
|
-
}
|
|
304
|
-
}
|
|
305
|
-
```
|
|
306
|
-
|
|
307
|
-
Your MCP server will be:
|
|
308
|
-
- ✅ Listed in the registry
|
|
309
|
-
- 🔍 Searchable via REST API
|
|
310
|
-
- 📦 Available in npm package
|
|
311
|
-
- 🌐 Featured on [ToolSDK.ai](https://toolsdk.ai)
|
|
312
|
-
|
|
313
|
-
📖 **Source of truth (schema, fields, remotes, OAuth)**: [CONTRIBUTING.md](./CONTRIBUTING.md)
|
|
314
|
-
|
|
315
|
-
📚 Additional docs: [docs/guide.md](./docs/guide.md)
|
|
316
|
-
|
|
317
303
|
---
|
|
318
304
|
|
|
319
305
|
<a id="mcp-servers"></a>
|