MCP, MCP server
io.github.akintomiwa-fisayo/openapi-sync-mcp
OpenAPI Sync is a powerful developer tool that automates the synchronization of your API documentation with your codebase using OpenAPI (formerly Swagger) specifications.
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
PERMISSION_DELETE_FILES NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP
Why this grade
- PERMISSION_DELETE_FILES Low
Contains a call that can delete files.
index.ts, line 376
fs.unlinkSync(p); - NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
client-generators.ts, line 335
content += ` const response = await fetch(\`\${globalConfig.baseURL}\${url}\`, {\n`; - SECRETS_PATH_DOTENV Low
Mentions a .env file.
Openapi-sync/spec-auth.ts, line 10
* Useful for test suites and environments where .env files are modified at runtime. - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
types.ts, line 377
* auth: { type: "bearer", token: process.env.MY_API_TOKEN || "${env.MY_API_TOKEN}" } - OBFUSCATION_FILE_OVER_READ_CAP Note
A file was over the read cap and was not fully read.
package-lock.json, line 1
{
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Concern
can delete files.
PERMISSION_DELETE_FILES
index.ts, line 376
fs.unlinkSync(p);
bin/cli.js, line 1253
fs.unlinkSync(filePath);
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
client-generators.ts, line 335
content += ` const response = await fetch(\`\${globalConfig.baseURL}\${url}\`, {\n`;
client-generators.ts, line 342
content += ` const response = await fetch(\`\${globalConfig.baseURL}\${url}\`, {\n`;
Openapi-sync/doctor.ts, line 136
const res = await axios.get(apiUrl, { timeout: 10000, ...authConfig });
Show more
Openapi-sync/index.ts, line 2147
let curl = "";
Openapi-sync/index.ts, line 2227
const curlCmd = `${generatedCurl || `curl ${serverUrl + endpointPath} -X ${method.toUpperCase()}`}${extras}`;
Openapi-sync/index.ts, line 2228
curl = isPython
Openapi-sync/interactive-init.ts, line 217
title: "next-fetch (Next.js Fetch)",
Openapi-sync/validate.ts, line 60
const response = await axios.get(apiUrl, { timeout: 15000, ...authConfig });
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
types.ts, line 377
* auth: { type: "bearer", token: process.env.MY_API_TOKEN || "${env.MY_API_TOKEN}" }
types.ts, line 383
* auth: { type: "apiKey", in: "header", name: "X-API-Key", value: process.env.API_KEY! }
Openapi-sync/spec-auth.ts, line 10
* Useful for test suites and environments where .env files are modified at runtime.
Show more
Openapi-sync/spec-auth.ts, line 18
* 1. .env.local
Openapi-sync/spec-auth.ts, line 19
* 2. .env
Openapi-sync/spec-auth.ts, line 28
// 1. Check .env.local and .env
Openapi-sync/spec-auth.ts, line 29
const envFiles = [".env.local", ".env"];
Openapi-sync/spec-auth.ts, line 80
* Automatically loads .env, .env.local, and next.config.js if present.
Openapi-sync/spec-auth.ts, line 90
`Please set it in your environment, terminal, .env/.env.local, or next.config.js before running openapi-sync. ` +
website/components/Features.tsx, line 94
"Full support for Bearer tokens, Basic auth, API keys, and custom headers with dynamic ${env.VAR} resolution from .env and .env.local files.",
website/components/docs/DocsContent.tsx, line 570
token: process.env.BILLING_API_TOKEN!,
website/components/docs/DocsContent.tsx, line 580
password: process.env.INTERNAL_PASSWORD!,
website/components/docs/DocsContent.tsx, line 591
value: process.env.ANALYTICS_KEY!,
website/components/docs/DocsContent.tsx, line 602
"X-Api-Secret": process.env.API_SECRET!,
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Note
a file was over the read cap and was not fully read.
OBFUSCATION_FILE_OVER_READ_CAP
package-lock.json, line 1
{
website/package-lock.json, line 1
{
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit 8f9cde064e70. can delete files. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.
Date and source
Date checked:
github.com
Commit graded: 8f9cde064e70c66071fa31223663cb7651941357
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.