@mcp-catalog/vinkius 0.1.0 → 0.1.2
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.
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"meta-tools.d.ts","sourceRoot":"","sources":["../../src/tools/meta-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;
|
|
1
|
+
{"version":3,"file":"meta-tools.d.ts","sourceRoot":"","sources":["../../src/tools/meta-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAmF1E"}
|
package/dist/tools/meta-tools.js
CHANGED
|
@@ -4,14 +4,15 @@
|
|
|
4
4
|
* These tools allow the agent to discover, search, activate, and
|
|
5
5
|
* manage MCP servers without needing any pre-configured subscriptions.
|
|
6
6
|
*/
|
|
7
|
+
import { z } from 'zod';
|
|
7
8
|
/** Register all meta-tools on the MCP server instance. */
|
|
8
9
|
export function registerMetaTools(server, client) {
|
|
9
10
|
// ── catalog_search ─────────────────────────────────────────────────────
|
|
10
11
|
server.tool('catalog_search', 'Search the Vinkius MCP marketplace to find servers that match your needs. ' +
|
|
11
12
|
'Returns relevant MCPs with descriptions, top tools, ratings, and activation instructions. ' +
|
|
12
13
|
'Use this when you need a capability that is not yet activated.', {
|
|
13
|
-
query:
|
|
14
|
-
limit:
|
|
14
|
+
query: z.string().describe('What you need (e.g., "track cloud spending", "manage github issues")'),
|
|
15
|
+
limit: z.number().optional().describe('Max results to return (default: 10)'),
|
|
15
16
|
}, async (args) => {
|
|
16
17
|
const result = await client.search(args.query, args.limit ?? 10);
|
|
17
18
|
return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
|
|
@@ -26,7 +27,7 @@ export function registerMetaTools(server, client) {
|
|
|
26
27
|
server.tool('catalog_activate', 'Activate (subscribe to) an MCP server from the marketplace. ' +
|
|
27
28
|
'For free MCPs, activation is instant and tools become available immediately. ' +
|
|
28
29
|
'For paid MCPs, returns a checkout URL that the user must open in a browser.', {
|
|
29
|
-
listing_id:
|
|
30
|
+
listing_id: z.string().describe('The listing UUID to activate (from catalog_search results)'),
|
|
30
31
|
}, async (args) => {
|
|
31
32
|
const result = await client.activate(args.listing_id);
|
|
32
33
|
return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
|
|
@@ -34,7 +35,7 @@ export function registerMetaTools(server, client) {
|
|
|
34
35
|
// ── catalog_deactivate ─────────────────────────────────────────────────
|
|
35
36
|
server.tool('catalog_deactivate', 'Deactivate (unsubscribe from) an MCP server. ' +
|
|
36
37
|
'Revokes access and removes the server tools from the catalog.', {
|
|
37
|
-
subscription_id:
|
|
38
|
+
subscription_id: z.string().describe('The subscription UUID to deactivate (from catalog_analytics)'),
|
|
38
39
|
}, async (args) => {
|
|
39
40
|
const result = await client.deactivate(args.subscription_id);
|
|
40
41
|
return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"meta-tools.js","sourceRoot":"","sources":["../../src/tools/meta-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;
|
|
1
|
+
{"version":3,"file":"meta-tools.js","sourceRoot":"","sources":["../../src/tools/meta-tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"proxy-tools.d.ts","sourceRoot":"","sources":["../../src/tools/proxy-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;
|
|
1
|
+
{"version":3,"file":"proxy-tools.d.ts","sourceRoot":"","sources":["../../src/tools/proxy-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAsDtD,gFAAgF;AAChF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,aAAa,EACrB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Cf"}
|
|
@@ -5,6 +5,49 @@
|
|
|
5
5
|
* MCP servers via the catalog meta-tools. Each tool is namespaced as
|
|
6
6
|
* `{listing_slug}__{tool_name}` to prevent collisions.
|
|
7
7
|
*/
|
|
8
|
+
import { z } from 'zod';
|
|
9
|
+
/**
|
|
10
|
+
* Convert a JSON Schema `properties` map to a Zod raw shape.
|
|
11
|
+
*
|
|
12
|
+
* The MCP SDK v1.12+ requires Zod schemas. API responses contain plain
|
|
13
|
+
* JSON Schema objects, so we need to convert them to Zod at registration time.
|
|
14
|
+
* We map basic JSON Schema types; anything unrecognised becomes z.any().
|
|
15
|
+
*/
|
|
16
|
+
function jsonSchemaPropertiesToZodShape(properties) {
|
|
17
|
+
if (!properties || Object.keys(properties).length === 0) {
|
|
18
|
+
return {};
|
|
19
|
+
}
|
|
20
|
+
const shape = {};
|
|
21
|
+
for (const [key, prop] of Object.entries(properties)) {
|
|
22
|
+
let schema;
|
|
23
|
+
switch (prop?.type) {
|
|
24
|
+
case 'string':
|
|
25
|
+
schema = z.string();
|
|
26
|
+
break;
|
|
27
|
+
case 'number':
|
|
28
|
+
case 'integer':
|
|
29
|
+
schema = z.number();
|
|
30
|
+
break;
|
|
31
|
+
case 'boolean':
|
|
32
|
+
schema = z.boolean();
|
|
33
|
+
break;
|
|
34
|
+
case 'array':
|
|
35
|
+
schema = z.array(z.unknown());
|
|
36
|
+
break;
|
|
37
|
+
case 'object':
|
|
38
|
+
schema = z.record(z.string(), z.any());
|
|
39
|
+
break;
|
|
40
|
+
default:
|
|
41
|
+
schema = z.any();
|
|
42
|
+
}
|
|
43
|
+
if (prop?.description) {
|
|
44
|
+
schema = schema.describe(prop.description);
|
|
45
|
+
}
|
|
46
|
+
// Make all proxy tool params optional — the upstream server handles validation
|
|
47
|
+
shape[key] = schema.optional();
|
|
48
|
+
}
|
|
49
|
+
return shape;
|
|
50
|
+
}
|
|
8
51
|
/** Refresh all proxy tools on the MCP server based on current subscriptions. */
|
|
9
52
|
export async function refreshProxyTools(server, client, registeredTools) {
|
|
10
53
|
const response = await client.getTools();
|
|
@@ -16,8 +59,10 @@ export async function refreshProxyTools(server, client, registeredTools) {
|
|
|
16
59
|
if (registeredTools.has(tool.name)) {
|
|
17
60
|
continue;
|
|
18
61
|
}
|
|
62
|
+
// Convert JSON Schema properties to Zod shape
|
|
63
|
+
const zodShape = jsonSchemaPropertiesToZodShape(tool.inputSchema?.properties);
|
|
19
64
|
// Register the proxy tool
|
|
20
|
-
server.tool(tool.name, `[${catalogServer.title}] ${tool.description}`,
|
|
65
|
+
server.tool(tool.name, `[${catalogServer.title}] ${tool.description}`, zodShape, async (args) => {
|
|
21
66
|
const result = await client.execute(tool.name, args);
|
|
22
67
|
return {
|
|
23
68
|
content: result.content,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"proxy-tools.js","sourceRoot":"","sources":["../../src/tools/proxy-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;
|
|
1
|
+
{"version":3,"file":"proxy-tools.js","sourceRoot":"","sources":["../../src/tools/proxy-tools.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mcp-catalog/vinkius",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "Unlock apps and data for your AI agents instantly — 2,000+ hardened, governed MCP servers via a single stdio connection",
|
|
5
5
|
"author": "Vinkius",
|
|
6
6
|
"license": "MIT",
|
|
@@ -44,7 +44,8 @@
|
|
|
44
44
|
"prepublishOnly": "npm run build"
|
|
45
45
|
},
|
|
46
46
|
"dependencies": {
|
|
47
|
-
"@modelcontextprotocol/sdk": "^1.
|
|
47
|
+
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
48
|
+
"zod": "^4.3.6"
|
|
48
49
|
},
|
|
49
50
|
"devDependencies": {
|
|
50
51
|
"@types/node": "^22.0.0",
|