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
node dist/src/start.jsEnvironment 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
tmcp
A server implementation for the Model Context Protocol (MCP) to enable LLMs to access external context and tools.
frontmcp
The CodeCall plugin provides AgentScript-based meta-tools for orchestrating MCP tools, enabling programmatic discovery, description, execution, and invocation of server capabilities within a sandboxed JavaScript environment.
boilerplate-mcp-server
Provides a production-ready foundation for developing custom Model Context Protocol (MCP) servers in TypeScript to connect AI assistants with external APIs and data sources, exemplified by an IP geolocation tool.
leanmcp-sdk
Building production-ready Model Context Protocol (MCP) servers with TypeScript, supporting features like authentication, elicitation, and UI integration for AI agents.