使用说明

项目简介

Fibery MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，它充当 Fibery 工作空间和支持 MCP 协议的 LLM 客户端（如 Claude for Desktop）之间的桥梁。通过这个服务器，用户可以使用自然语言与 Fibery 进行交互，实现数据查询、信息获取和工作流程自动化等功能。

主要功能点

自然语言查询 Fibery 实体: 允许用户通过自然语言描述在 Fibery 中检索信息。
数据库结构探索: 提供查看 Fibery 数据库及其字段详情的能力，帮助用户理解数据结构。
实体数据管理: 支持通过对话界面创建和更新 Fibery 实体，简化数据操作流程。
工具集成: 内置多种工具，如列出数据库、描述数据库、查询数据库、创建实体和更新实体，方便 LLM 客户端调用。

安装步骤

环境准备:
- 确保已拥有 Fibery 账户和 API Token。
- 安装 Python 3.10 或更高版本。
- 安装 'uv' 工具（推荐使用，简化 Python 工具管理）：uv 安装指南

安装 Fibery MCP 服务器: 使用 'uv tool install' 命令安装 'fibery-mcp-server'：

uv tool install fibery-mcp-server

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 Fibery MCP 服务器，您需要在客户端的配置文件中添加服务器配置信息。以 Claude Desktop 为例，您可以在 Settings → Developer → Edit Config 中编辑配置文件，并添加如下 JSON 配置：

{
    "mcpServers": {
        "fibery-mcp-server": {
            "command": "uv",
            "args": [
                 "tool",
                 "run",
                 "fibery-mcp-server",
                 "--fibery-host",
                 "your-domain.fibery.io",  // 替换为您的 Fibery 域名，例如 your-account.fibery.io
                 "--fibery-api-token",
                 "your-api-token"         // 替换为您的 Fibery API Token
            ]
        }
    }
}

配置参数说明:

'"fibery-mcp-server"': 服务器名称，您可以自定义，用于在 MCP 客户端中标识该服务器。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 工具。如果 'uv' 命令不可用，请尝试使用 'uv' 的绝对路径，例如 '/Users/username/.local/bin/uv'。
'"args"': 启动参数列表，包括：
- '"tool"': 指定使用 'uv tool' 子命令。
- '"run"': 运行指定的工具。
- '"fibery-mcp-server"': 要运行的工具名称，即 Fibery MCP 服务器。
- '"--fibery-host"': Fibery 主机地址，请替换为您的 Fibery 域名 (例如 'your-domain.fibery.io')。
- '"--fibery-api-token"': Fibery API Token，用于服务器安全访问您的 Fibery 工作空间。请替换为您的 API Token。

开发模式配置 (可选):

如果您克隆了 'fibery-mcp-server' 仓库到本地进行开发，可以使用以下配置，指向本地代码目录：

{
    "mcpServers": {
        "fibery-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/fibery-mcp-server", // 替换为您的本地仓库路径
                "run",
                "fibery-mcp-server",
                "--fibery-host",
                 "your-domain.fibery.io",       // 替换为您的 Fibery 域名
                 "--fibery-api-token",          // 替换为您的 Fibery API Token
            ]
        }
    }
}

'"--directory"': 指定本地仓库路径，用于开发环境。请替换 '"path/to/cloned/fibery-mcp-server"' 为您克隆仓库的实际路径。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中选择您配置的服务器名称（例如 'fibery-mcp-server'），即可开始使用以下工具与 Fibery 工作空间进行交互：

列出数据库 (list_databases): 获取 Fibery 工作空间中所有数据库的列表。
描述数据库 (describe_database): 查看指定数据库的详细结构，包括所有字段的标题、名称和类型。
查询数据库 (query_database): 使用 Fibery API 强大的查询能力，灵活检索数据。
创建实体 (create_entity): 在指定的 Fibery 数据库中创建新的实体记录。
更新实体 (update_entity): 修改已存在的 Fibery 实体记录。

具体工具的使用方法和参数，请参考各个工具的详细描述或在 LLM 客户端中通过自然语言指令进行探索。

关键词