Openfga MCP

🚀 OpenFGA MCP 服務器

一個實驗性的 模型上下文協議 (MCP) 服務器，使大型語言模型 (LLMs) 能夠讀取、搜索和操作 OpenFGA 存儲。解鎖代理式 AI 的授權，併為人類實現精細的 氛圍編碼 ✨。

🚀 快速開始

要求

• Python 3.12+
• 一個 OpenFGA 服務器

運行服務器

make run \
  OPENFGA_URL=http://127.0.0.1:8080 \
  STORE_ID=your-store-id \
  MODEL_ID=your-model-id

✨ 主要特性

工具

存儲管理

• create_store: 創建新存儲。 (create-store)
• list_stores: 列出所有存儲。 (list-stores)
• get_store: 獲取存儲詳細信息。 (get-store)
• delete_store: 刪除存儲。 (delete-store)
• get_store_id_by_name: 根據名稱獲取存儲 ID。

授權模型管理

• write_authorization_model: 寫入授權模型。 (write-authorization-model)
• read_authorization_models: 列出所有授權模型。 (read-authorization-models)
• get_authorization_model: 獲取授權模型。 (get-authorization-model)

關係元組管理

• batch_get_triples: 批量獲取關係元組。 (batch-get-triples)
• get_triple: 獲取單個關係元組。 (get-triple)
• upsert_triple: 插入或更新關係元組。 (upsert-triple)
• delete_triples: 刪除關係元組。 (delete-triples)

查詢

• check_permission: 檢查權限。
• list_objects: 列出對象。
• list_users_or_groups: 列出用戶或組。

📦 安裝指南

開發環境設置

make setup

運行開發服務器

make run \
  OPENFGA_URL=http://127.0.0.1:8080 \
  STORE_ID=your-store-id \
  MODEL_ID=your-model-id

📦 集成

與Claude集成

在配置文件中添加以下內容：

{
  "mcpInspectors": {
    "default": {
      "class": "OpenFGAInspector",
      "args": {
        "baseUrl": "http://localhost:8081"
      }
    }
  }
}

📄 許可證

Apache 2.0