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?

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

MCP Server
la-rebelion
-
security
A
license
-
quality
MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
Last updated -
4
3
TypeScript
MIT License
MCP Server
agentico-dev
-
security
A
license
-
quality
MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
Last updated -
13
2
TypeScript
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 -
47
1
JavaScript
MIT License
MCP API Service
nstanw
A
security
F
license
A
quality
A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
Last updated -
21
76
JavaScript

View all related MCP servers

MCP Server NestJS