使用说明

SharePoint MCP Server

Servidor MCP (Model Context Protocol) para acceder a listas de SharePoint usando Microsoft Graph API.

Características

Acceso a cualquier lista de SharePoint en tu dominio
Soporte para múltiples sitios
Autenticación segura via Azure AD
Despliegue via Docker
Configuración por variables de entorno

Configuración

1. Variables de Entorno

Crea un archivo .env basado en .env.example:

cp .env.example .env

Edita .env con tus credenciales:

SP_CLIENT_ID=tu-client-id
SP_CLIENT_SECRET=tu-client-secret
SP_TENANT_ID=tu-tenant-id

2. Ejecución Local

# Compilar y ejecutar
dotnet run

# O publicar como single executable
dotnet publish -c Release -r linux-x64 --self-contained

3. Despliegue con Docker

# Construir imagen
docker build -t sharepoint-mcp-server .

# Ejecutar con variables de entorno
docker run -e SP_CLIENT_ID="$SP_CLIENT_ID" \
           -e SP_CLIENT_SECRET="$SP_CLIENT_SECRET" \
           -e SP_TENANT_ID="$SP_TENANT_ID" \
           sharepoint-mcp-server

# O con docker-compose
cp .env.example .env
# Editar .env con valores reales
docker-compose up -d

Uso como Herramienta MCP

El servidor expone las siguientes herramientas:

`ListarElementosSharePoint`

Lista elementos de cualquier lista de SharePoint.

Parámetros:

listName (requerido): Nombre de la lista
siteName (opcional): Nombre del sitio (default: "ARCAComitesJD-UAT")

Ejemplo:

{
  "tool": "ListarElementosSharePoint",
  "arguments": {
    "listName": "Lugar",
    "siteName": "ARCAComitesJD-UAT"
  }
}

Herramientas Adicionales

Saludar: Saludo simple
ObtenerFechaHora: Fecha y hora actual
DiasHastaFecha: Días hasta una fecha específica
Calcular: Operaciones matemáticas básicas
GenerarPassword: Generador de contraseñas seguras

Despliegue en la Nube

Opción 1: VPS/VM (DigitalOcean, Linode, etc.)

Instala Docker
Copia los archivos del proyecto
Configura las variables de entorno
Ejecuta docker-compose up -d

Opción 2: Railway/Vercel/Render

Conecta tu repo Git
Configura las variables de entorno en el dashboard
Despliega automáticamente

Opción 3: Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: sharepoint-mcp-server
spec:
  replicas: 1
  selector:
    matchLabels:
      app: sharepoint-mcp-server
  template:
    metadata:
      labels:
        app: sharepoint-mcp-server
    spec:
      containers:
      - name: sharepoint-mcp-server
        image: sharepoint-mcp-server:latest
        env:
        - name: SP_CLIENT_ID
          valueFrom:
            secretKeyRef:
              name: sharepoint-secrets
              key: client-id
        - name: SP_CLIENT_SECRET
          valueFrom:
            secretKeyRef:
              name: sharepoint-secrets
              key: client-secret
        - name: SP_TENANT_ID
          valueFrom:
            secretKeyRef:
              name: sharepoint-secrets
              key: tenant-id

Seguridad

Nunca expongas las credenciales en el código
Usa variables de entorno o secrets management
Considera usar Azure Key Vault para producción
Rotación regular de secrets

Troubleshooting

Errores Comunes

Authentication failed: Verifica que las credenciales sean correctas
List not found: Confirma el nombre exacto de la lista y sitio
Permission denied: Asegura que la app tenga permisos en SharePoint

Logs

Los logs se envían a stderr para compatibilidad con MCP.

Contribuir

Fork el repo
Crea una feature branch
Submit un pull request