servidor aps-mcp

Servidor de protocolo de contexto de modelo experimental creado con Node.js, que proporciona acceso a la API de Autodesk Platform Services , con control de acceso detallado mediante la nueva función de cuentas de servicio seguras .

Vídeo de YouTube

Desarrollo

Prerrequisitos

• Node.js

• Credenciales de la aplicación APS (deben ser de tipo aplicación de servidor a servidor )

• Acceso provisto a ACC o BIM360

Configuración

• Clonar este repositorio

• Instalar dependencias: yarn install

• Construya el código TypeScript: yarn run build

• Cree un archivo .env en la carpeta raíz de este proyecto y agregue sus credenciales de APS:

  • APS_CLIENT_ID : su ID de cliente de la aplicación APS

  • APS_CLIENT_SECRET : el secreto del cliente de su aplicación APS

• Crear una nueva cuenta de servicio: npx create-service-account ssa-test-user John Doe

  • Este script generará un correo electrónico de la cuenta de servicio recién creada y un conjunto de variables de entorno.

• Agregue o sobrescriba las nuevas variables de entorno en su archivo .env

  • APS_SA_ID - su ID de cuenta de servicio

  • APS_SA_EMAIL - el correo electrónico de su cuenta de servicio

  • APS_SA_KEY_ID : el ID de clave de su cuenta de servicio

  • APS_SA_PRIVATE_KEY : la clave privada de su cuenta de servicio

• Invita al correo electrónico de la cuenta de servicio como nuevo miembro a tus proyectos ACC

Usar con Inspector

• Ejecutar el inspector de protocolo de contexto del modelo : yarn run inspect

• Abra http://localhost:5173

• Pulse Connect para iniciar este servidor MCP y conectarse a él

Usar con Claude Desktop

• Asegúrate de tener instalado Claude Desktop

• Crea un archivo de configuración de Claude Desktop si aún no tienes uno:

  • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • En Windows: %APPDATA%\Claude\claude_desktop_config.json

• Agregue este servidor MCP a la configuración, utilizando la ruta absoluta del archivo build/server.js en su sistema, por ejemplo:

{
    "mcpServers": {
        "autodesk-platform-services": {
            "command": "node",
            "args": [
                "/absolute/path/to/aps-mcp-server/build/server.js"
            ]
        }
    }
}

• Abra Claude Desktop y pruebe alguna de las siguientes indicaciones de prueba:

  • ¿A qué proyectos del ACC tengo acceso?

  • Dame un panel visual de todos los problemas en el proyecto XYZ

Para obtener más detalles sobre cómo agregar servidores MCP a Claude Desktop, consulte la documentación oficial .