Servidor MCP OpenFGA

Un servidor experimental de Protocolo de Contexto de Modelo (MCP) que permite a los Modelos de Lenguaje Grandes (LLM) leer, buscar y manipular almacenes OpenFGA . Facilita la autorización para IA con agentes y la codificación de vibraciones de grano fino ✨ para humanos.

Requisitos

• Python 3.12+

• Un servidor OpenFGA

Related MCP server: OpsLevel MCP

Características

Herramientas

Gestión de tiendas

• create_store : Crea una nueva tienda. ( create-store )

• list_stores : Lista todas las tiendas. ( list-stores )

• get_store : Obtener los detalles de una tienda. ( get-store )

• delete_store : Eliminar una tienda. ( delete-store )

• get_store_id_by_name : obtiene el ID de una tienda por su nombre.

Gestión del modelo de autorización

• write_authorization_model : Escribe un modelo de autorización. ( write-authorization-model )

• read_authorization_models : enumera todos los modelos de autorización. ( read-authorization-models )

• get_authorization_model : obtiene una versión particular de los detalles de un modelo de autorización. ( get-authorization-model )

Gestión de tuplas de relaciones

• write_relation_tuples : Escribe tuplas de relación. ( write-relation-tuples )

• read_relation_tuples : Lee tuplas de relación. ( read-relation-tuples )

Consultas de relación

• check : Comprueba si un usuario tiene una relación con un objeto. ( comprobar )

• list_objects : enumera objetos de un tipo con el que un usuario tiene una relación. ( list-objects )

• list_users : enumera los usuarios que tienen una relación determinada con un objeto determinado. ( list-users )

Recursos

Indicaciones

Uso

Recomendamos ejecutar el servidor utilizando UVX :

uvx openfga-mcp@latest

Instalación mediante herrería

Para instalar OpenFGA MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @evansims/openfga-mcp --client claude

Configuración

El servidor acepta los siguientes argumentos:

• --openfga_url : URL de su servidor OpenFGA

• --openfga_store : ID del almacén OpenFGA que utilizará el servidor MCP

• --openfga_model : ID del modelo de autorización OpenFGA que utilizará el servidor MCP

Para la autenticación del token API:

• --openfga_token : token de API para usar con su servidor OpenFGA

Para la autenticación de credenciales de cliente:

• --openfga_client_id : ID de cliente para usar con su servidor OpenFGA

• --openfga_client_secret : Secreto de cliente para usar con su servidor OpenFGA

• --openfga_api_issuer : emisor de API para usar con su servidor OpenFGA

• --openfga_api_audience : audiencia de API para usar con su servidor OpenFGA

Por ejemplo:

uvx openfga-mcp@latest \
  --openfga_url="http://127.0.0.1:8080" \
  --openfga_store="your-store-id" \
  --openfga_model="your-model-id"

Uso con Claude Desktop

Para configurar a Claude para que use el servidor, agregue lo siguiente a su configuración de Claude:

{
  "mcpServers": {
    "openfga-mcp": {
      "command": "uvx",
      "args": ["openfga-mcp@latest"]
    }
  }
}

• Quizás necesite especificar la ruta completa del ejecutable uvx . Use which uvx para encontrarlo.

• Debes reiniciar Claude después de actualizar la configuración.

Uso con Raycast

Uso con cursor

Uso con Windsurf

Desarrollo

Para configurar su entorno de desarrollo, ejecute:

make setup

Para ejecutar el servidor de desarrollo:

make run \
  --openfga_url="http://127.0.0.1:8080" \
  --openfga_store="your-store-id" \
  --openfga_model="your-model-id"

Para ejecutar el servidor de desarrollo con el Inspector MCP:

make dev

Licencia

Apache 2.0