Servidor MCP NestJS

Servidor MCP (NestJS)

Una aplicación robusta, escalable y extensible del lado del servidor, desarrollada con NestJS . Este proyecto proporciona una implementación de servidor del Protocolo de Contexto de Modelo (MCP), gestión de archivos, autenticación y API REST modulares para publicaciones y usuarios.

Tabla de contenido

Características

Servidor MCP : implementa el protocolo de contexto de modelo para operaciones de archivos y más.
Gestión de archivos : cargue, descargue, enumere y elimine archivos a través de puntos finales REST.
Autenticación : autenticación basada en JWT con estrategia local.
Módulos de usuario y publicación : Estructura modular para usuarios y publicaciones con DTO y entidades.
Integración con Swagger : documentación API lista para usar.
Extensible : agregue fácilmente nuevos módulos y funciones.

Arquitectura

NestJS : marco progresivo Node.js para crear aplicaciones del lado del servidor eficientes, confiables y escalables.
Integración MCP : utiliza un FileBrowserMCP personalizado para operaciones de archivos.
Diseño modular : cada característica está encapsulada en su propio módulo.

Empezando

Prerrequisitos

Node.js (se recomienda v18+)
npm (viene con Node.js)
Git

Instalación

# Clone the repository
$ git clone https://github.com/Cstannahill/mcp-server-nestjs.git
$ cd nestjs-mcp-server

# Install dependencies
$ npm install

Variables de entorno

Cree un archivo .env en el directorio raíz para cualquier secreto o anulación de configuración (opcional).

Desarrollo

Ejecución del servidor

# Start in development mode (with hot reload)
$ npm run start:dev

# Start in production mode
$ npm run start:prod

Comandos útiles

# Compile TypeScript
$ npm run build

# Lint code
$ npm run lint

Pruebas

Ejecutar pruebas unitarias

$ npm run test

Ejecutar pruebas de extremo a extremo (e2e)

$ npm run test:e2e

Cobertura de la prueba

$ npm run test:cov

Despliegue

Construir el proyecto:
$ npm run build
Iniciar el servidor:
$ npm run start:prod
Para una implementación avanzada (Docker, nube, etc.), consulte la Documentación de implementación de NestJS .

Referencia de API

Swagger UI está disponible (si está habilitada) en /api cuando el servidor se está ejecutando.
Puntos finales principales:
- POST /auth/login — Autenticar y recibir JWT
- POST /files/upload — Subir un archivo
- GET /files/:id Descargar un archivo
- DELETE /files/:id — Eliminar un archivo
- GET /files — Lista de archivos
- POST /users — Crear un usuario
- POST /posts — Crear una publicación

Consulte los archivos del controlador en src/ para obtener más detalles.

Estructura del proyecto

src/
  app.module.ts         # Root module
  main.ts               # Entry point
  auth/                 # Authentication (JWT, guards, strategies)
  file/                 # File management (upload, download, delete)
  mcps/                 # Model Context Protocol integration
  posts/                # Posts module
  users/                # Users module
  database/             # Database connection (if used)
uploads/                 # Uploaded files (local dev)

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/YourFeature )
Confirme sus cambios ( git commit -am 'Add some feature' )
Empujar a la rama ( git push origin feature/YourFeature )
Abrir una solicitud de extracción

Estándares de codificación

Siga el estilo de código existente (ver configuración de ESLint)
Escribir pruebas unitarias y de extremo a extremo para nuevas funciones
Documente su código y actualice el archivo README según sea necesario

Configuración de Git

Este proyecto utiliza Git para el control de versiones. El origen remoto está configurado como:

https://github.com/Cstannahill/mcp-server-nestjs.git

Licencia

Nest tiene licencia MIT .

Recursos y apoyo

Si tiene alguna pregunta, problema o solicitud de funciones, abra un problema o comuníquese con el mantenedor.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Una aplicación robusta del lado del servidor que implementa el Protocolo de Contexto de Modelo (MCP) para operaciones de archivos, proporcionando autenticación y API REST modulares para administrar archivos, usuarios y publicaciones.

Related MCP Servers

Filesystem MCP Server
bsmi021
-
security
A
license
-
quality
A Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
Last updated -
4
MIT License
File Operations MCP Server
bsmi021
A
security
A
license
A
quality
A Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.
Last updated -
16
MIT License
MCP Local File Reader
sworddut
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.
Last updated -
6
10
MIT License
MCP Filesystem Server
safurrier
A
security
A
license
A
quality
A Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.
Last updated -
21
47
MIT License

View all related MCP servers

MCP Server NestJS