OpenFGA MCP 服务器

一个实验性的 模型上下文协议 (MCP) 服务器，使大型语言模型 (LLM) 能够读取、搜索和操作 OpenFGA 存储。 为 Agentic AI 解锁授权，并为人类提供细粒度的 氛围编码✨。

要求

• Python 3.12+
• 一个 OpenFGA 服务器

功能

工具

• check: 检查用户是否与对象具有关系
• list_objects: 列出用户具有关系的某种类型的对象
• write_tuples: 将元组写入 OpenFGA 存储
• read_tuples: 从 OpenFGA 存储读取元组
• get_authorization_model: 获取当前的授权模型

资源

提示

用法

我们建议使用 UVX 运行服务器：

uvx openfga-mcp@latest

配置

服务器接受以下参数：

• --openfga_url: 您的 OpenFGA 服务器的 URL
• --openfga_store: MCP 服务器将使用的 OpenFGA 存储的 ID
• --openfga_model: MCP 服务器将使用的 OpenFGA 授权模型的 ID

对于 API 令牌身份验证：

• --openfga_token: 用于您的 OpenFGA 服务器的 API 令牌

对于客户端凭据身份验证：

• --openfga_client_id: 用于您的 OpenFGA 服务器的客户端 ID
• --openfga_client_secret: 用于您的 OpenFGA 服务器的客户端密钥
• --openfga_api_issuer: 用于您的 OpenFGA 服务器的 API 颁发者
• --openfga_api_audience: 用于您的 OpenFGA 服务器的 API 受众

例如：

uvx openfga-mcp@latest \
  --openfga_url="http://127.0.0.1:8000" \
  --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 一起使用

与 Cursor 一起使用

与 Windsurf 一起使用

开发

要设置您的开发环境，请运行：

uv sync

要运行开发服务器：

uv run openfga-mcp

许可证

Apache 2.0