tamabahan
This commit is contained in:
86
bin/build.ts
Normal file
86
bin/build.ts
Normal file
@@ -0,0 +1,86 @@
|
|||||||
|
|
||||||
|
import { execSync } from "node:child_process";
|
||||||
|
import { readdir, rm, mkdir, cp } from "node:fs/promises";
|
||||||
|
import { join, relative, dirname } from "node:path";
|
||||||
|
|
||||||
|
const SRC = "src";
|
||||||
|
const DIST = "dist";
|
||||||
|
|
||||||
|
const ASSET_EXT = [
|
||||||
|
".svg", ".png", ".jpg", ".jpeg", ".webp", ".gif",
|
||||||
|
".json", ".html", ".css", ".txt", ".ico", ".md"
|
||||||
|
];
|
||||||
|
|
||||||
|
// Recursively scan directory tree
|
||||||
|
async function walk(dir: string): Promise<string[]> {
|
||||||
|
const entries = await readdir(dir, { withFileTypes: true });
|
||||||
|
const files: string[] = [];
|
||||||
|
|
||||||
|
for (const entry of entries) {
|
||||||
|
const full = join(dir, entry.name);
|
||||||
|
if (entry.isDirectory()) {
|
||||||
|
files.push(...await walk(full));
|
||||||
|
} else {
|
||||||
|
files.push(full);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return files;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function build() {
|
||||||
|
console.log("🧹 Cleaning dist/...");
|
||||||
|
|
||||||
|
await rm(DIST, { recursive: true, force: true });
|
||||||
|
await mkdir(DIST, { recursive: true });
|
||||||
|
|
||||||
|
console.log("🔍 Scanning src/...");
|
||||||
|
|
||||||
|
const allFiles = await walk(SRC);
|
||||||
|
|
||||||
|
const tsFiles = allFiles.filter(f =>
|
||||||
|
f.endsWith(".ts") || f.endsWith(".tsx") || f.endsWith(".js")
|
||||||
|
);
|
||||||
|
|
||||||
|
const assets = allFiles.filter(f =>
|
||||||
|
ASSET_EXT.some(ext => f.toLowerCase().endsWith(ext))
|
||||||
|
);
|
||||||
|
|
||||||
|
console.log("⚡ Building & Minifying TypeScript...");
|
||||||
|
|
||||||
|
for (const file of tsFiles) {
|
||||||
|
const rel = relative(SRC, file);
|
||||||
|
const outDir = join(DIST, dirname(rel));
|
||||||
|
|
||||||
|
await mkdir(outDir, { recursive: true });
|
||||||
|
|
||||||
|
await Bun.build({
|
||||||
|
entrypoints: [file],
|
||||||
|
outdir: outDir,
|
||||||
|
splitting: false,
|
||||||
|
minify: true, // ← minify otomatis
|
||||||
|
sourcemap: "external",
|
||||||
|
target: "browser"
|
||||||
|
});
|
||||||
|
|
||||||
|
console.log(" ✔ Built:", rel);
|
||||||
|
}
|
||||||
|
|
||||||
|
console.log("📁 Copying assets...");
|
||||||
|
|
||||||
|
for (const file of assets) {
|
||||||
|
const rel = relative(SRC, file);
|
||||||
|
const dest = join(DIST, rel);
|
||||||
|
|
||||||
|
await mkdir(dirname(dest), { recursive: true });
|
||||||
|
await cp(file, dest);
|
||||||
|
|
||||||
|
console.log(" ✔ Copied:", rel);
|
||||||
|
}
|
||||||
|
|
||||||
|
console.log("🎉 Build complete!");
|
||||||
|
}
|
||||||
|
|
||||||
|
execSync("npm version patch", { stdio: 'inherit' })
|
||||||
|
build()
|
||||||
|
|
||||||
3
bin/publish.ts
Normal file
3
bin/publish.ts
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
import { execSync } from "child_process";
|
||||||
|
|
||||||
|
execSync("npm publish", { stdio: 'inherit' })
|
||||||
@@ -7,73 +7,319 @@ exports.convertOpenApiToMcpTools = convertOpenApiToMcpTools;
|
|||||||
exports.getMcpTools = getMcpTools;
|
exports.getMcpTools = getMcpTools;
|
||||||
const lodash_1 = __importDefault(require("lodash"));
|
const lodash_1 = __importDefault(require("lodash"));
|
||||||
/**
|
/**
|
||||||
* Convert OpenAPI 3.x JSON spec into MCP-compatible tool definitions (without run()).
|
* Convert OpenAPI 3.x JSON spec into MCP-compatible tool definitions.
|
||||||
* Hanya menyertakan endpoint yang memiliki tag berisi "mcp".
|
|
||||||
*/
|
*/
|
||||||
function convertOpenApiToMcpTools(openApiJson, filterTag) {
|
function convertOpenApiToMcpTools(openApiJson, filterTag) {
|
||||||
var _a, _b, _c;
|
|
||||||
const tools = [];
|
const tools = [];
|
||||||
|
if (!openApiJson || typeof openApiJson !== "object") {
|
||||||
|
console.warn("Invalid OpenAPI JSON");
|
||||||
|
return tools;
|
||||||
|
}
|
||||||
const paths = openApiJson.paths || {};
|
const paths = openApiJson.paths || {};
|
||||||
|
if (Object.keys(paths).length === 0) {
|
||||||
|
console.warn("No paths found in OpenAPI spec");
|
||||||
|
return tools;
|
||||||
|
}
|
||||||
for (const [path, methods] of Object.entries(paths)) {
|
for (const [path, methods] of Object.entries(paths)) {
|
||||||
// ✅ skip semua path internal MCP
|
if (!path || typeof path !== "string")
|
||||||
|
continue;
|
||||||
if (path.startsWith("/mcp"))
|
if (path.startsWith("/mcp"))
|
||||||
continue;
|
continue;
|
||||||
|
if (!methods || typeof methods !== "object")
|
||||||
|
continue;
|
||||||
for (const [method, operation] of Object.entries(methods)) {
|
for (const [method, operation] of Object.entries(methods)) {
|
||||||
const tags = Array.isArray(operation.tags) ? operation.tags : [];
|
const validMethods = ["get", "post", "put", "delete", "patch", "head", "options"];
|
||||||
// ✅ exclude semua yang tidak punya tag atau tag-nya tidak mengandung "mcp"
|
if (!validMethods.includes(method.toLowerCase()))
|
||||||
if (!tags.length || !tags.some(t => t.toLowerCase().includes(filterTag)))
|
|
||||||
continue;
|
continue;
|
||||||
const rawName = lodash_1.default.snakeCase(operation.operationId || `${method}_${path}`) || "unnamed_tool";
|
if (!operation || typeof operation !== "object")
|
||||||
const name = cleanToolName(rawName);
|
continue;
|
||||||
const description = operation.description ||
|
const tags = Array.isArray(operation.tags) ? operation.tags : [];
|
||||||
operation.summary ||
|
if (!tags.length || !tags.some(t => typeof t === "string" && t.toLowerCase().includes(filterTag)))
|
||||||
`Execute ${method.toUpperCase()} ${path}`;
|
continue;
|
||||||
const schema = ((_c = (_b = (_a = operation.requestBody) === null || _a === void 0 ? void 0 : _a.content) === null || _b === void 0 ? void 0 : _b["application/json"]) === null || _c === void 0 ? void 0 : _c.schema) || {
|
try {
|
||||||
type: "object",
|
const tool = createToolFromOperation(path, method, operation, tags);
|
||||||
properties: {},
|
if (tool) {
|
||||||
additionalProperties: true,
|
tools.push(tool);
|
||||||
};
|
}
|
||||||
const tool = {
|
}
|
||||||
name,
|
catch (error) {
|
||||||
description,
|
console.error(`Error creating tool for ${method.toUpperCase()} ${path}:`, error);
|
||||||
"x-props": {
|
continue;
|
||||||
method: method.toUpperCase(),
|
}
|
||||||
path,
|
|
||||||
operationId: operation.operationId,
|
|
||||||
tag: tags[0],
|
|
||||||
deprecated: operation.deprecated || false,
|
|
||||||
summary: operation.summary,
|
|
||||||
},
|
|
||||||
inputSchema: Object.assign(Object.assign({}, schema), { additionalProperties: true, $schema: "http://json-schema.org/draft-07/schema#" }),
|
|
||||||
};
|
|
||||||
tools.push(tool);
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
return tools;
|
return tools;
|
||||||
}
|
}
|
||||||
/**
|
/**
|
||||||
* Bersihkan nama agar valid untuk digunakan sebagai tool name
|
* Buat MCP tool dari operation OpenAPI
|
||||||
* - hapus karakter spesial
|
*/
|
||||||
* - ubah slash jadi underscore
|
function createToolFromOperation(path, method, operation, tags) {
|
||||||
* - hilangkan prefix umum (get_, post_, api_, dll)
|
try {
|
||||||
* - rapikan underscore berganda
|
const rawName = lodash_1.default.snakeCase(operation.operationId || `${method}_${path}`) || "unnamed_tool";
|
||||||
|
const name = cleanToolName(rawName);
|
||||||
|
if (!name || name === "unnamed_tool") {
|
||||||
|
console.warn(`Invalid tool name for ${method} ${path}`);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
const description = operation.description ||
|
||||||
|
operation.summary ||
|
||||||
|
`Execute ${method.toUpperCase()} ${path}`;
|
||||||
|
// ✅ Extract schema berdasarkan method
|
||||||
|
let schema;
|
||||||
|
if (method.toLowerCase() === "get") {
|
||||||
|
// ✅ Untuk GET, ambil dari parameters (query/path)
|
||||||
|
schema = extractParametersSchema(operation.parameters || []);
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
// ✅ Untuk POST/PUT/etc, ambil dari requestBody
|
||||||
|
schema = extractRequestBodySchema(operation);
|
||||||
|
}
|
||||||
|
const inputSchema = createInputSchema(schema);
|
||||||
|
return {
|
||||||
|
name,
|
||||||
|
description,
|
||||||
|
"x-props": {
|
||||||
|
method: method.toUpperCase(),
|
||||||
|
path,
|
||||||
|
operationId: operation.operationId,
|
||||||
|
tag: tags[0],
|
||||||
|
deprecated: operation.deprecated || false,
|
||||||
|
summary: operation.summary,
|
||||||
|
},
|
||||||
|
inputSchema,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
console.error(`Failed to create tool from operation:`, error);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Extract schema dari parameters (untuk GET requests)
|
||||||
|
*/
|
||||||
|
function extractParametersSchema(parameters) {
|
||||||
|
var _a;
|
||||||
|
if (!Array.isArray(parameters) || parameters.length === 0) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
const properties = {};
|
||||||
|
const required = [];
|
||||||
|
for (const param of parameters) {
|
||||||
|
if (!param || typeof param !== "object")
|
||||||
|
continue;
|
||||||
|
// ✅ Support path, query, dan header parameters
|
||||||
|
if (["path", "query", "header"].includes(param.in)) {
|
||||||
|
const paramName = param.name;
|
||||||
|
if (!paramName || typeof paramName !== "string")
|
||||||
|
continue;
|
||||||
|
properties[paramName] = {
|
||||||
|
type: ((_a = param.schema) === null || _a === void 0 ? void 0 : _a.type) || "string",
|
||||||
|
description: param.description || `${param.in} parameter: ${paramName}`,
|
||||||
|
};
|
||||||
|
// ✅ Copy field tambahan dari schema
|
||||||
|
if (param.schema) {
|
||||||
|
const allowedFields = ["examples", "example", "default", "enum", "pattern", "minLength", "maxLength", "minimum", "maximum", "format"];
|
||||||
|
for (const field of allowedFields) {
|
||||||
|
if (param.schema[field] !== undefined) {
|
||||||
|
properties[paramName][field] = param.schema[field];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (param.required === true) {
|
||||||
|
required.push(paramName);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (Object.keys(properties).length === 0) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
return {
|
||||||
|
type: "object",
|
||||||
|
properties,
|
||||||
|
required,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Extract schema dari requestBody (untuk POST/PUT/etc requests)
|
||||||
|
*/
|
||||||
|
function extractRequestBodySchema(operation) {
|
||||||
|
var _a, _b;
|
||||||
|
if (!((_a = operation.requestBody) === null || _a === void 0 ? void 0 : _a.content)) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
const content = operation.requestBody.content;
|
||||||
|
const contentTypes = [
|
||||||
|
"application/json",
|
||||||
|
"multipart/form-data",
|
||||||
|
"application/x-www-form-urlencoded",
|
||||||
|
"text/plain",
|
||||||
|
];
|
||||||
|
for (const contentType of contentTypes) {
|
||||||
|
if ((_b = content[contentType]) === null || _b === void 0 ? void 0 : _b.schema) {
|
||||||
|
return content[contentType].schema;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (const [_, value] of Object.entries(content)) {
|
||||||
|
if (value === null || value === void 0 ? void 0 : value.schema) {
|
||||||
|
return value.schema;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Buat input schema yang valid untuk MCP
|
||||||
|
*/
|
||||||
|
function createInputSchema(schema) {
|
||||||
|
const defaultSchema = {
|
||||||
|
type: "object",
|
||||||
|
properties: {},
|
||||||
|
additionalProperties: false,
|
||||||
|
};
|
||||||
|
if (!schema || typeof schema !== "object") {
|
||||||
|
return defaultSchema;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
const properties = {};
|
||||||
|
const required = [];
|
||||||
|
const originalRequired = Array.isArray(schema.required) ? schema.required : [];
|
||||||
|
if (schema.properties && typeof schema.properties === "object") {
|
||||||
|
for (const [key, prop] of Object.entries(schema.properties)) {
|
||||||
|
if (!key || typeof key !== "string")
|
||||||
|
continue;
|
||||||
|
try {
|
||||||
|
const cleanProp = cleanProperty(prop);
|
||||||
|
if (cleanProp) {
|
||||||
|
properties[key] = cleanProp;
|
||||||
|
// ✅ PERBAIKAN: Check optional flag dengan benar
|
||||||
|
const isOptional = (prop === null || prop === void 0 ? void 0 : prop.optional) === true || (prop === null || prop === void 0 ? void 0 : prop.optional) === "true";
|
||||||
|
const isInRequired = originalRequired.includes(key);
|
||||||
|
// ✅ Hanya masukkan ke required jika memang required DAN bukan optional
|
||||||
|
if (isInRequired && !isOptional) {
|
||||||
|
required.push(key);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
console.error(`Error cleaning property ${key}:`, error);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return {
|
||||||
|
type: "object",
|
||||||
|
properties,
|
||||||
|
required,
|
||||||
|
additionalProperties: false,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
console.error("Error creating input schema:", error);
|
||||||
|
return defaultSchema;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Bersihkan property dari field custom
|
||||||
|
*/
|
||||||
|
function cleanProperty(prop) {
|
||||||
|
if (!prop || typeof prop !== "object") {
|
||||||
|
return { type: "string" };
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
const cleaned = {
|
||||||
|
type: prop.type || "string",
|
||||||
|
};
|
||||||
|
const allowedFields = [
|
||||||
|
"description",
|
||||||
|
"examples",
|
||||||
|
"example",
|
||||||
|
"default",
|
||||||
|
"enum",
|
||||||
|
"pattern",
|
||||||
|
"minLength",
|
||||||
|
"maxLength",
|
||||||
|
"minimum",
|
||||||
|
"maximum",
|
||||||
|
"format",
|
||||||
|
"multipleOf",
|
||||||
|
"exclusiveMinimum",
|
||||||
|
"exclusiveMaximum",
|
||||||
|
];
|
||||||
|
for (const field of allowedFields) {
|
||||||
|
if (prop[field] !== undefined && prop[field] !== null) {
|
||||||
|
cleaned[field] = prop[field];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (prop.properties && typeof prop.properties === "object") {
|
||||||
|
cleaned.properties = {};
|
||||||
|
for (const [key, value] of Object.entries(prop.properties)) {
|
||||||
|
const cleanedNested = cleanProperty(value);
|
||||||
|
if (cleanedNested) {
|
||||||
|
cleaned.properties[key] = cleanedNested;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (Array.isArray(prop.required)) {
|
||||||
|
cleaned.required = prop.required.filter((r) => typeof r === "string");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (prop.items) {
|
||||||
|
cleaned.items = cleanProperty(prop.items);
|
||||||
|
}
|
||||||
|
if (Array.isArray(prop.oneOf)) {
|
||||||
|
cleaned.oneOf = prop.oneOf.map(cleanProperty).filter(Boolean);
|
||||||
|
}
|
||||||
|
if (Array.isArray(prop.anyOf)) {
|
||||||
|
cleaned.anyOf = prop.anyOf.map(cleanProperty).filter(Boolean);
|
||||||
|
}
|
||||||
|
if (Array.isArray(prop.allOf)) {
|
||||||
|
cleaned.allOf = prop.allOf.map(cleanProperty).filter(Boolean);
|
||||||
|
}
|
||||||
|
return cleaned;
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
console.error("Error cleaning property:", error);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Bersihkan nama tool
|
||||||
*/
|
*/
|
||||||
function cleanToolName(name) {
|
function cleanToolName(name) {
|
||||||
return name
|
if (!name || typeof name !== "string") {
|
||||||
.replace(/[{}]/g, "")
|
return "unnamed_tool";
|
||||||
.replace(/[^a-zA-Z0-9_]/g, "_")
|
}
|
||||||
.replace(/_+/g, "_")
|
try {
|
||||||
.replace(/^_|_$/g, "")
|
return name
|
||||||
.replace(/^(get|post|put|delete|patch|api)_/i, "")
|
.replace(/[{}]/g, "")
|
||||||
.replace(/^(get_|post_|put_|delete_|patch_|api_)+/gi, "")
|
.replace(/[^a-zA-Z0-9_]/g, "_")
|
||||||
.replace(/(^_|_$)/g, "");
|
.replace(/_+/g, "_")
|
||||||
|
.replace(/^_|_$/g, "")
|
||||||
|
.replace(/^(get|post|put|delete|patch|api)_/i, "")
|
||||||
|
.replace(/^(get_|post_|put_|delete_|patch_|api_)+/gi, "")
|
||||||
|
.replace(/(^_|_$)/g, "")
|
||||||
|
|| "unnamed_tool";
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
console.error("Error cleaning tool name:", error);
|
||||||
|
return "unnamed_tool";
|
||||||
|
}
|
||||||
}
|
}
|
||||||
/**
|
/**
|
||||||
* Ambil OpenAPI JSON dari endpoint dan konversi ke tools MCP
|
* Ambil OpenAPI JSON dari endpoint dan konversi ke tools MCP
|
||||||
*/
|
*/
|
||||||
async function getMcpTools(url, filterTag) {
|
async function getMcpTools(url, filterTag) {
|
||||||
const data = await fetch(url);
|
try {
|
||||||
const openApiJson = await data.json();
|
console.log(`Fetching OpenAPI spec from: ${url}`);
|
||||||
const tools = convertOpenApiToMcpTools(openApiJson, filterTag);
|
const response = await fetch(url);
|
||||||
return tools;
|
if (!response.ok) {
|
||||||
|
throw new Error(`HTTP error! status: ${response.status}`);
|
||||||
|
}
|
||||||
|
const openApiJson = await response.json();
|
||||||
|
const tools = convertOpenApiToMcpTools(openApiJson, filterTag);
|
||||||
|
console.log(`✅ Successfully generated ${tools.length} MCP tools`);
|
||||||
|
return tools;
|
||||||
|
}
|
||||||
|
catch (error) {
|
||||||
|
console.error("Error fetching MCP tools:", error);
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -106,15 +106,16 @@ async function handleMCPRequest(request, tools) {
|
|||||||
const baseUrl = credentials === null || credentials === void 0 ? void 0 : credentials.baseUrl;
|
const baseUrl = credentials === null || credentials === void 0 ? void 0 : credentials.baseUrl;
|
||||||
const token = credentials === null || credentials === void 0 ? void 0 : credentials.token;
|
const token = credentials === null || credentials === void 0 ? void 0 : credentials.token;
|
||||||
const result = await executeTool(tool, (params === null || params === void 0 ? void 0 : params.arguments) || {}, baseUrl, token);
|
const result = await executeTool(tool, (params === null || params === void 0 ? void 0 : params.arguments) || {}, baseUrl, token);
|
||||||
|
const data = result.data.data;
|
||||||
|
const isObject = typeof data === "object" && data !== null;
|
||||||
return {
|
return {
|
||||||
jsonrpc: "2.0",
|
jsonrpc: "2.0",
|
||||||
id,
|
id,
|
||||||
result: {
|
result: {
|
||||||
content: [
|
content: [
|
||||||
{
|
isObject
|
||||||
type: "text",
|
? { type: "json", data: data }
|
||||||
text: JSON.stringify(result, null, 2),
|
: { type: "text", text: JSON.stringify(data || result.data || result) },
|
||||||
},
|
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "n8n-nodes-openapi-mcp-server",
|
"name": "n8n-nodes-openapi-mcp-server",
|
||||||
"version": "1.1.15",
|
"version": "1.1.19",
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"n8n",
|
"n8n",
|
||||||
"n8n-nodes"
|
"n8n-nodes"
|
||||||
|
|||||||
36
package.json
36
package.json
@@ -1,29 +1,37 @@
|
|||||||
|
{
|
||||||
{
|
"name": "n8n-nodes-openapi-mcp-server",
|
||||||
"name": "n8n-mcp-server",
|
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"private": true,
|
"private": true,
|
||||||
|
"version": "1.0.1",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"gen": "bunx tsc && cp package.txt n8n-nodes-openapi-mcp-server/package.json && cp icon.svg n8n-nodes-openapi-mcp-server/nodes/icon.svg"
|
"build": "bun bin/build.ts",
|
||||||
},
|
"publish": "bun bin/publish.ts"
|
||||||
"dependencies": {
|
|
||||||
"express": "^5.1.0",
|
|
||||||
"lodash": "^4.17.21",
|
|
||||||
"n8n-core": "^1.117.1",
|
|
||||||
"n8n-workflow": "^1.116.0",
|
|
||||||
"nock": "^14.0.10",
|
|
||||||
"ssh2": "^1.17.0"
|
|
||||||
},
|
},
|
||||||
|
"dependencies": {},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
|
"express": "^5.1.0",
|
||||||
"@types/bun": "latest",
|
"@types/bun": "latest",
|
||||||
"@types/lodash": "^4.17.20",
|
"@types/lodash": "^4.17.20",
|
||||||
"@types/express": "^5.0.5",
|
"@types/express": "^5.0.5",
|
||||||
"@types/node": "^24.10.0",
|
"@types/node": "^24.10.0",
|
||||||
"@types/ssh2": "^1.15.5",
|
"@types/ssh2": "^1.15.5",
|
||||||
"prettier": "^3.6.2",
|
"n8n-core": "^1.117.1",
|
||||||
"ts-node": "^10.9.2"
|
"n8n-workflow": "^1.116.0",
|
||||||
|
"nock": "^14.0.10",
|
||||||
|
"ssh2": "^1.17.0",
|
||||||
|
"dedent": "^1.7.0",
|
||||||
|
"lodash": "^4.17.21"
|
||||||
},
|
},
|
||||||
"peerDependencies": {
|
"peerDependencies": {
|
||||||
"typescript": "^5"
|
"typescript": "^5"
|
||||||
|
},
|
||||||
|
"n8n": {
|
||||||
|
"nodes": [
|
||||||
|
"dist/nodes/OpenapiMcpServer.js"
|
||||||
|
],
|
||||||
|
"n8nNodesApiVersion": 1,
|
||||||
|
"credentials": [
|
||||||
|
"dist/credentials/OpenapiMcpServerCredentials.credentials.js"
|
||||||
|
]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -15,57 +15,50 @@ interface McpTool {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Convert OpenAPI 3.x JSON spec into MCP-compatible tool definitions (without run()).
|
* Convert OpenAPI 3.x JSON spec into MCP-compatible tool definitions.
|
||||||
* Hanya menyertakan endpoint yang memiliki tag berisi "mcp".
|
|
||||||
*/
|
*/
|
||||||
export function convertOpenApiToMcpTools(openApiJson: any, filterTag: string): McpTool[] {
|
export function convertOpenApiToMcpTools(openApiJson: any, filterTag: string): McpTool[] {
|
||||||
const tools: McpTool[] = [];
|
const tools: McpTool[] = [];
|
||||||
|
|
||||||
|
if (!openApiJson || typeof openApiJson !== "object") {
|
||||||
|
console.warn("Invalid OpenAPI JSON");
|
||||||
|
return tools;
|
||||||
|
}
|
||||||
|
|
||||||
const paths = openApiJson.paths || {};
|
const paths = openApiJson.paths || {};
|
||||||
|
|
||||||
|
if (Object.keys(paths).length === 0) {
|
||||||
|
console.warn("No paths found in OpenAPI spec");
|
||||||
|
return tools;
|
||||||
|
}
|
||||||
|
|
||||||
for (const [path, methods] of Object.entries(paths)) {
|
for (const [path, methods] of Object.entries(paths)) {
|
||||||
// ✅ skip semua path internal MCP
|
if (!path || typeof path !== "string") continue;
|
||||||
if (path.startsWith("/mcp")) continue;
|
if (path.startsWith("/mcp")) continue;
|
||||||
|
|
||||||
for (const [method, operation] of Object.entries<any>(methods as any)) {
|
if (!methods || typeof methods !== "object") continue;
|
||||||
|
|
||||||
|
for (const [method, operation] of Object.entries<any>(methods)) {
|
||||||
|
const validMethods = ["get", "post", "put", "delete", "patch", "head", "options"];
|
||||||
|
if (!validMethods.includes(method.toLowerCase())) continue;
|
||||||
|
|
||||||
|
if (!operation || typeof operation !== "object") continue;
|
||||||
|
|
||||||
const tags: string[] = Array.isArray(operation.tags) ? operation.tags : [];
|
const tags: string[] = Array.isArray(operation.tags) ? operation.tags : [];
|
||||||
|
|
||||||
// ✅ exclude semua yang tidak punya tag atau tag-nya tidak mengandung "mcp"
|
if (!tags.length || !tags.some(t =>
|
||||||
if (!tags.length || !tags.some(t => t.toLowerCase().includes(filterTag))) continue;
|
typeof t === "string" && t.toLowerCase().includes(filterTag)
|
||||||
|
)) continue;
|
||||||
|
|
||||||
const rawName = _.snakeCase(operation.operationId || `${method}_${path}`) || "unnamed_tool";
|
try {
|
||||||
const name = cleanToolName(rawName);
|
const tool = createToolFromOperation(path, method, operation, tags);
|
||||||
|
if (tool) {
|
||||||
const description =
|
tools.push(tool);
|
||||||
operation.description ||
|
}
|
||||||
operation.summary ||
|
} catch (error) {
|
||||||
`Execute ${method.toUpperCase()} ${path}`;
|
console.error(`Error creating tool for ${method.toUpperCase()} ${path}:`, error);
|
||||||
|
continue;
|
||||||
const schema =
|
}
|
||||||
operation.requestBody?.content?.["application/json"]?.schema || {
|
|
||||||
type: "object",
|
|
||||||
properties: {},
|
|
||||||
additionalProperties: true,
|
|
||||||
};
|
|
||||||
|
|
||||||
const tool: McpTool = {
|
|
||||||
name,
|
|
||||||
description,
|
|
||||||
"x-props": {
|
|
||||||
method: method.toUpperCase(),
|
|
||||||
path,
|
|
||||||
operationId: operation.operationId,
|
|
||||||
tag: tags[0],
|
|
||||||
deprecated: operation.deprecated || false,
|
|
||||||
summary: operation.summary,
|
|
||||||
},
|
|
||||||
inputSchema: {
|
|
||||||
...schema,
|
|
||||||
additionalProperties: true,
|
|
||||||
$schema: "http://json-schema.org/draft-07/schema#",
|
|
||||||
},
|
|
||||||
};
|
|
||||||
|
|
||||||
tools.push(tool);
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -73,29 +66,316 @@ export function convertOpenApiToMcpTools(openApiJson: any, filterTag: string): M
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Bersihkan nama agar valid untuk digunakan sebagai tool name
|
* Buat MCP tool dari operation OpenAPI
|
||||||
* - hapus karakter spesial
|
*/
|
||||||
* - ubah slash jadi underscore
|
function createToolFromOperation(
|
||||||
* - hilangkan prefix umum (get_, post_, api_, dll)
|
path: string,
|
||||||
* - rapikan underscore berganda
|
method: string,
|
||||||
|
operation: any,
|
||||||
|
tags: string[]
|
||||||
|
): McpTool | null {
|
||||||
|
try {
|
||||||
|
const rawName = _.snakeCase(operation.operationId || `${method}_${path}`) || "unnamed_tool";
|
||||||
|
const name = cleanToolName(rawName);
|
||||||
|
|
||||||
|
if (!name || name === "unnamed_tool") {
|
||||||
|
console.warn(`Invalid tool name for ${method} ${path}`);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
const description =
|
||||||
|
operation.description ||
|
||||||
|
operation.summary ||
|
||||||
|
`Execute ${method.toUpperCase()} ${path}`;
|
||||||
|
|
||||||
|
// ✅ Extract schema berdasarkan method
|
||||||
|
let schema;
|
||||||
|
if (method.toLowerCase() === "get") {
|
||||||
|
// ✅ Untuk GET, ambil dari parameters (query/path)
|
||||||
|
schema = extractParametersSchema(operation.parameters || []);
|
||||||
|
} else {
|
||||||
|
// ✅ Untuk POST/PUT/etc, ambil dari requestBody
|
||||||
|
schema = extractRequestBodySchema(operation);
|
||||||
|
}
|
||||||
|
|
||||||
|
const inputSchema = createInputSchema(schema);
|
||||||
|
|
||||||
|
return {
|
||||||
|
name,
|
||||||
|
description,
|
||||||
|
"x-props": {
|
||||||
|
method: method.toUpperCase(),
|
||||||
|
path,
|
||||||
|
operationId: operation.operationId,
|
||||||
|
tag: tags[0],
|
||||||
|
deprecated: operation.deprecated || false,
|
||||||
|
summary: operation.summary,
|
||||||
|
},
|
||||||
|
inputSchema,
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
console.error(`Failed to create tool from operation:`, error);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Extract schema dari parameters (untuk GET requests)
|
||||||
|
*/
|
||||||
|
function extractParametersSchema(parameters: any[]): any {
|
||||||
|
if (!Array.isArray(parameters) || parameters.length === 0) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
const properties: any = {};
|
||||||
|
const required: string[] = [];
|
||||||
|
|
||||||
|
for (const param of parameters) {
|
||||||
|
if (!param || typeof param !== "object") continue;
|
||||||
|
|
||||||
|
// ✅ Support path, query, dan header parameters
|
||||||
|
if (["path", "query", "header"].includes(param.in)) {
|
||||||
|
const paramName = param.name;
|
||||||
|
if (!paramName || typeof paramName !== "string") continue;
|
||||||
|
|
||||||
|
properties[paramName] = {
|
||||||
|
type: param.schema?.type || "string",
|
||||||
|
description: param.description || `${param.in} parameter: ${paramName}`,
|
||||||
|
};
|
||||||
|
|
||||||
|
// ✅ Copy field tambahan dari schema
|
||||||
|
if (param.schema) {
|
||||||
|
const allowedFields = ["examples", "example", "default", "enum", "pattern", "minLength", "maxLength", "minimum", "maximum", "format"];
|
||||||
|
for (const field of allowedFields) {
|
||||||
|
if (param.schema[field] !== undefined) {
|
||||||
|
properties[paramName][field] = param.schema[field];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (param.required === true) {
|
||||||
|
required.push(paramName);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (Object.keys(properties).length === 0) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
type: "object",
|
||||||
|
properties,
|
||||||
|
required,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Extract schema dari requestBody (untuk POST/PUT/etc requests)
|
||||||
|
*/
|
||||||
|
function extractRequestBodySchema(operation: any): any {
|
||||||
|
if (!operation.requestBody?.content) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
const content = operation.requestBody.content;
|
||||||
|
|
||||||
|
const contentTypes = [
|
||||||
|
"application/json",
|
||||||
|
"multipart/form-data",
|
||||||
|
"application/x-www-form-urlencoded",
|
||||||
|
"text/plain",
|
||||||
|
];
|
||||||
|
|
||||||
|
for (const contentType of contentTypes) {
|
||||||
|
if (content[contentType]?.schema) {
|
||||||
|
return content[contentType].schema;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
for (const [_, value] of Object.entries<any>(content)) {
|
||||||
|
if (value?.schema) {
|
||||||
|
return value.schema;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Buat input schema yang valid untuk MCP
|
||||||
|
*/
|
||||||
|
function createInputSchema(schema: any): any {
|
||||||
|
const defaultSchema = {
|
||||||
|
type: "object",
|
||||||
|
properties: {},
|
||||||
|
additionalProperties: false,
|
||||||
|
};
|
||||||
|
|
||||||
|
if (!schema || typeof schema !== "object") {
|
||||||
|
return defaultSchema;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const properties: any = {};
|
||||||
|
const required: string[] = [];
|
||||||
|
const originalRequired = Array.isArray(schema.required) ? schema.required : [];
|
||||||
|
|
||||||
|
if (schema.properties && typeof schema.properties === "object") {
|
||||||
|
for (const [key, prop] of Object.entries<any>(schema.properties)) {
|
||||||
|
if (!key || typeof key !== "string") continue;
|
||||||
|
|
||||||
|
try {
|
||||||
|
const cleanProp = cleanProperty(prop);
|
||||||
|
if (cleanProp) {
|
||||||
|
properties[key] = cleanProp;
|
||||||
|
|
||||||
|
// ✅ PERBAIKAN: Check optional flag dengan benar
|
||||||
|
const isOptional = prop?.optional === true || prop?.optional === "true";
|
||||||
|
const isInRequired = originalRequired.includes(key);
|
||||||
|
|
||||||
|
// ✅ Hanya masukkan ke required jika memang required DAN bukan optional
|
||||||
|
if (isInRequired && !isOptional) {
|
||||||
|
required.push(key);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (error) {
|
||||||
|
console.error(`Error cleaning property ${key}:`, error);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
type: "object",
|
||||||
|
properties,
|
||||||
|
required,
|
||||||
|
additionalProperties: false,
|
||||||
|
};
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Error creating input schema:", error);
|
||||||
|
return defaultSchema;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Bersihkan property dari field custom
|
||||||
|
*/
|
||||||
|
function cleanProperty(prop: any): any | null {
|
||||||
|
if (!prop || typeof prop !== "object") {
|
||||||
|
return { type: "string" };
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const cleaned: any = {
|
||||||
|
type: prop.type || "string",
|
||||||
|
};
|
||||||
|
|
||||||
|
const allowedFields = [
|
||||||
|
"description",
|
||||||
|
"examples",
|
||||||
|
"example",
|
||||||
|
"default",
|
||||||
|
"enum",
|
||||||
|
"pattern",
|
||||||
|
"minLength",
|
||||||
|
"maxLength",
|
||||||
|
"minimum",
|
||||||
|
"maximum",
|
||||||
|
"format",
|
||||||
|
"multipleOf",
|
||||||
|
"exclusiveMinimum",
|
||||||
|
"exclusiveMaximum",
|
||||||
|
];
|
||||||
|
|
||||||
|
for (const field of allowedFields) {
|
||||||
|
if (prop[field] !== undefined && prop[field] !== null) {
|
||||||
|
cleaned[field] = prop[field];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (prop.properties && typeof prop.properties === "object") {
|
||||||
|
cleaned.properties = {};
|
||||||
|
for (const [key, value] of Object.entries(prop.properties)) {
|
||||||
|
const cleanedNested = cleanProperty(value);
|
||||||
|
if (cleanedNested) {
|
||||||
|
cleaned.properties[key] = cleanedNested;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (Array.isArray(prop.required)) {
|
||||||
|
cleaned.required = prop.required.filter((r: any) => typeof r === "string");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (prop.items) {
|
||||||
|
cleaned.items = cleanProperty(prop.items);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (Array.isArray(prop.oneOf)) {
|
||||||
|
cleaned.oneOf = prop.oneOf.map(cleanProperty).filter(Boolean);
|
||||||
|
}
|
||||||
|
if (Array.isArray(prop.anyOf)) {
|
||||||
|
cleaned.anyOf = prop.anyOf.map(cleanProperty).filter(Boolean);
|
||||||
|
}
|
||||||
|
if (Array.isArray(prop.allOf)) {
|
||||||
|
cleaned.allOf = prop.allOf.map(cleanProperty).filter(Boolean);
|
||||||
|
}
|
||||||
|
|
||||||
|
return cleaned;
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Error cleaning property:", error);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Bersihkan nama tool
|
||||||
*/
|
*/
|
||||||
function cleanToolName(name: string): string {
|
function cleanToolName(name: string): string {
|
||||||
return name
|
if (!name || typeof name !== "string") {
|
||||||
.replace(/[{}]/g, "")
|
return "unnamed_tool";
|
||||||
.replace(/[^a-zA-Z0-9_]/g, "_")
|
}
|
||||||
.replace(/_+/g, "_")
|
|
||||||
.replace(/^_|_$/g, "")
|
try {
|
||||||
.replace(/^(get|post|put|delete|patch|api)_/i, "")
|
return name
|
||||||
.replace(/^(get_|post_|put_|delete_|patch_|api_)+/gi, "")
|
.replace(/[{}]/g, "")
|
||||||
.replace(/(^_|_$)/g, "");
|
.replace(/[^a-zA-Z0-9_]/g, "_")
|
||||||
|
.replace(/_+/g, "_")
|
||||||
|
.replace(/^_|_$/g, "")
|
||||||
|
.replace(/^(get|post|put|delete|patch|api)_/i, "")
|
||||||
|
.replace(/^(get_|post_|put_|delete_|patch_|api_)+/gi, "")
|
||||||
|
.replace(/(^_|_$)/g, "")
|
||||||
|
|| "unnamed_tool";
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Error cleaning tool name:", error);
|
||||||
|
return "unnamed_tool";
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Ambil OpenAPI JSON dari endpoint dan konversi ke tools MCP
|
* Ambil OpenAPI JSON dari endpoint dan konversi ke tools MCP
|
||||||
*/
|
*/
|
||||||
export async function getMcpTools(url: string, filterTag: string) {
|
export async function getMcpTools(url: string, filterTag: string): Promise<McpTool[]> {
|
||||||
const data = await fetch(url);
|
try {
|
||||||
const openApiJson = await data.json();
|
|
||||||
const tools = convertOpenApiToMcpTools(openApiJson, filterTag);
|
console.log(`Fetching OpenAPI spec from: ${url}`);
|
||||||
return tools;
|
|
||||||
|
const response = await fetch(url);
|
||||||
|
|
||||||
|
if (!response.ok) {
|
||||||
|
throw new Error(`HTTP error! status: ${response.status}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
const openApiJson = await response.json();
|
||||||
|
const tools = convertOpenApiToMcpTools(openApiJson, filterTag);
|
||||||
|
|
||||||
|
console.log(`✅ Successfully generated ${tools.length} MCP tools`);
|
||||||
|
|
||||||
|
return tools;
|
||||||
|
} catch (error) {
|
||||||
|
console.error("Error fetching MCP tools:", error);
|
||||||
|
throw error;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -172,15 +172,17 @@ async function handleMCPRequest(
|
|||||||
token
|
token
|
||||||
);
|
);
|
||||||
|
|
||||||
|
const data = result.data.data;
|
||||||
|
const isObject = typeof data === "object" && data !== null;
|
||||||
|
|
||||||
return {
|
return {
|
||||||
jsonrpc: "2.0",
|
jsonrpc: "2.0",
|
||||||
id,
|
id,
|
||||||
result: {
|
result: {
|
||||||
content: [
|
content: [
|
||||||
{
|
isObject
|
||||||
type: "text",
|
? { type: "json", data: data }
|
||||||
text: JSON.stringify(result, null, 2),
|
: { type: "text", text: JSON.stringify(data || result.data || result) },
|
||||||
},
|
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -1,17 +1,17 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128"
|
||||||
<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128" aria-label="Icon AB square">
|
aria-label="Icon AB square">
|
||||||
<defs>
|
<defs>
|
||||||
<style>
|
<style>
|
||||||
.bg { fill: #111827; rx: 20; }
|
.letters {
|
||||||
.letters { fill: #f9fafb; font-family: "Inter", "Segoe UI", Roboto, sans-serif; font-weight: 800; font-size: 56px; }
|
fill: #3b82f6; /* biru */
|
||||||
|
font-family: "Inter", "Segoe UI", Roboto, sans-serif;
|
||||||
|
font-weight: 800;
|
||||||
|
font-size: 56px;
|
||||||
|
}
|
||||||
</style>
|
</style>
|
||||||
</defs>
|
</defs>
|
||||||
|
|
||||||
<!-- rounded square background -->
|
<text class="letters" x="64" y="78" text-anchor="middle" dominant-baseline="middle">MCP</text>
|
||||||
<rect class="bg" width="128" height="128" rx="20" ry="20"/>
|
|
||||||
|
|
||||||
<!-- letters -->
|
|
||||||
<text class="letters" x="64" y="78" text-anchor="middle" dominant-baseline="middle">mcp</text>
|
|
||||||
</svg>
|
</svg>
|
||||||
|
|
||||||
|
|
||||||
|
Before Width: | Height: | Size: 550 B After Width: | Height: | Size: 440 B |
Reference in New Issue
Block a user