@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.
Files changed (2) hide show
  1. package/README.md +23 -37
  2. 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
- Help grow the ecosystem! Share your AI tools, plugins, and integrations with the community.
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
  [![Watch the video](https://img.youtube.com/vi/J_oaDtCoVVo/hqdefault.jpg)](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>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@toolsdk.ai/registry",
3
- "version": "1.0.169",
3
+ "version": "1.0.170",
4
4
  "description": "An Open, Structured, and Standard Registry for MCP Servers and Packages.",
5
5
  "keywords": [
6
6
  "mcp",