OpenFGA MCP-сервер

Экспериментальный сервер Model Context Protocol (MCP), который позволяет моделям больших языков (LLM) читать, искать и манипулировать хранилищами OpenFGA . Разблокирует авторизацию для агентского ИИ и мелкозернистое кодирование вибраций ✨ для людей.

Требования

• Питон 3.12+

• Сервер OpenFGA

Related MCP server: gcp-mcp-server

Функции

Инструменты

Управление магазином

• create_store : Создает новый магазин. ( create-store )

• list_stores : Список всех магазинов. ( list-stores )

• get_store : Получить данные о магазине. ( get-store )

• delete_store : Удалить магазин. ( delete-store )

• get_store_id_by_name : Получить идентификатор магазина по его названию.

Управление моделью авторизации

• write_authorization_model : Написать модель авторизации. ( write-authorization-model )

• read_authorization_models : Список всех моделей авторизации. ( read-authorization-models )

• get_authorization_model : Получить конкретную версию сведений о модели авторизации. ( get-authorization-model )

Управление кортежами отношений

• write_relation_tuples : Запись кортежей отношений. ( write-relation-tuples )

• read_relation_tuples : Чтение кортежей отношений. ( read-relation-tuples )

Запросы на отношения

• check : проверка наличия связи между пользователем и объектом. ( проверка )

• list_objects : Список объектов типа, к которым пользователь имеет отношение. ( list-objects )

• list_users : Список пользователей, имеющих заданную связь с заданным объектом. ( list-users )

Ресурсы

Подсказки

Использование

Мы рекомендуем запустить сервер с использованием UVX :

uvx openfga-mcp@latest

Установка через Smithery

Чтобы автоматически установить OpenFGA MCP Server для Claude Desktop через Smithery :

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

Конфигурация

Сервер принимает следующие аргументы:

• --openfga_url : URL вашего сервера OpenFGA

• --openfga_store : идентификатор хранилища OpenFGA, которое будет использовать сервер MCP

• --openfga_model : идентификатор модели авторизации OpenFGA, которую будет использовать сервер MCP

Для аутентификации с помощью API-токена:

• --openfga_token : токен API для использования с вашим сервером OpenFGA

Для аутентификации учетных данных клиента:

• --openfga_client_id : идентификатор клиента для использования с вашим сервером OpenFGA

• --openfga_client_secret : Секрет клиента для использования с вашим сервером OpenFGA

• --openfga_api_issuer : API-издатель для использования с вашим сервером OpenFGA

• --openfga_api_audience : аудитория API для использования с вашим сервером OpenFGA

Например:

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

Использование с Claude Desktop

Чтобы настроить Claude на использование сервера, добавьте в конфигурацию Claude следующее:

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

• Вам может потребоваться указать полный путь к исполняемому файлу uvx . Используйте which uvx , чтобы найти его.

• После обновления конфигурации необходимо перезапустить Claude.

Использование с Raycast

Использование с курсором

Использование с виндсерфингом

Разработка

Чтобы настроить среду разработки, выполните:

make setup

Чтобы запустить сервер разработки:

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

Чтобы запустить сервер разработки с помощью MCP Inspector:

make dev

Лицензия

Апач 2.0