Back to Home
Bazilio-san icon

fa-mcp-sdk

by Bazilio-san

Overview

A production-ready framework for building Model Context Protocol (MCP) servers, enabling AI models to interact with custom tools, prompts, and resources.

Installation

Run Command
node dist/src/start.js

Environment Variables

  • SERVICE_NAME
  • PRODUCT_NAME
  • NODE_ENV
  • NODE_CONSUL_ENV
  • DEBUG
  • AD_SERVICE_PASSWORD
  • CACHE_TTL_SECONDS
  • DB_HOST
  • LOGGER_LEVEL
  • MCP_TRANSPORT_TYPE
  • WS_PORT
  • WS_AUTH_ENABLED
  • PM2_NAMESPACE

Security Notes

The server has a critical misconfiguration in its default CORS policy (`src/core/web/cors.ts`), which explicitly allows all origins (`callback(null, true);`). This exposes all HTTP endpoints, including the /mcp API, to cross-origin requests from any website, potentially leading to CSRF vulnerabilities or unauthorized access if other authentication mechanisms are bypassed or misconfigured. While rate limiting is present, and auth is configurable, this wide-open CORS is a significant risk. Additionally, the custom JWT-like token implementation (using symmetric AES-256 CTR encryption) in `src/core/auth/jwt.ts` has a hardcoded default `encryptKey` if not configured (a UUID `11111111-7777-8888-9999-000000000000`). If authentication is enabled and this default key is used, it severely compromises the security of generated tokens. The `cli-config.example.yaml` shows an auto-generated UUID, which is better, but the default in code is problematic. Logging has masking for sensitive data, which is a good practice. Path traversal checks exist in `src/core/web/svg-icons.ts`. NTLM and Basic authentication options require external configuration of credentials (AD or username/password).

Similar Servers

Stats

Interest Score0
Security Score5
Cost ClassLow
Avg Tokens100
Stars0
Forks0
Last Update2026-01-18

Tags

MCPTypeScriptAIFrameworkAPI