Servidor MCP Sidecar de Markdown

Esto proporciona una forma estructurada de servir y acceder a la documentación de Markdown desde un servidor MCP para paquetes NPM, módulos Go o paquetes PyPi. Permite la generación de código informado al exponer estos archivos de Markdown como resources o tools .

[!NOTA]
Nota: Muchos paquetes de PyPi no tienen documentos de Markdown expuestos, por lo que esta biblioteca también montará los documentos raíz help de Python de manera predeterminada.

Esto está diseñado para ejecutarse desde un directorio de proyecto donde los paquetes solicitados ya están instalados localmente. El acceso siempre se realiza dentro del directorio de trabajo de su entorno local.

Instalación

npx -y markdown-sidecar-mcp

Argumentos

workingDir : el directorio de trabajo de su repositorio.
packageName : El nombre del paquete o módulo a solicitar
registry : Registro en el que se encontrará el paquete ( npm , gomodules o pypi )
docsSubDir : [OPCIONAL] El subdirectorio específico donde buscar documentos de Markdown. El valor predeterminado es la raíz del paquete.
mcpPrimitive : [OPCIONAL] La primitiva MCP que se expondrá desde el servidor ( tool o resource ). Su valor predeterminado es tool ; algunos clientes no admiten recursos actualmente.

Pasos para la instalación del cursor

Agregue la siguiente definición de servidor a su archivo .cursor/mcp.json :

{
  "mcpServers": {
    "sidecar": {
      "command": "npx",
      "args": [
        "-y", "--package", "markdown-sidecar-mcp",
        "--",
        "mcp", "start",
        "--workingDir", "{REPO_WORKING_DIR}",
        "--packageName", "{PACKAGE_NAME}",
        "--registry", "npm"
      ]
    }
  }
}

Desarrollo

# Install dependencies
npm i

# Build
npm run build

# Run with Bun
npm run build:mcp

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones
Confirme sus cambios y envíelos hacia arriba
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Markdown Sidecar MCP Server

Integrations