项目简介

Insforge MCP 服务是Insforge平台的后端实现，它遵循Model Context Protocol (MCP) 标准，旨在通过结构化的方式向大型语言模型（LLM）客户端提供丰富的上下文信息和操作能力。它将复杂的后端API抽象为LLM可理解和调用的工具，使LLM能够直接执行数据库操作、存储管理、边缘函数部署及日志查询等任务。

主要功能点

该服务通过注册一系列工具，赋予LLM以下操作能力：

后端指令获取： 提供Insforge平台的关键设置、API端点和认证信息，是与Insforge后端交互的第一步。
数据库操作： 支持获取表的详细结构、索引后端元数据、执行原始SQL查询、以及通过CSV/JSON文件进行批量数据插入/更新。
云存储管理： 允许创建、列出和删除存储桶，管理文件存储空间。
边缘函数部署与管理： 支持创建、获取、更新和删除基于Deno运行时的边缘函数，实现自定义后端逻辑。
容器日志查看： 检索Insforge服务、PostgreSQL等关键组件的最新运行日志，便于调试和监控。

安装步骤

Insforge MCP 服务旨在作为您现有LLM客户端的插件或扩展运行。

通过Insforge安装器（推荐）： 运行以下命令，Insforge安装器将自动配置您的MCP客户端以连接Insforge MCP服务：
```
npx @insforge/install --client <您的客户端名称> --env API_KEY=您的API密钥 --env API_BASE_URL=http://localhost:7130
```
请将 '<您的客户端名称>' 替换为您的LLM客户端名称（例如 'claude-code', 'cursor' 等）。'您的API密钥' 替换为您的Insforge API密钥，'http://localhost:7130' 替换为您的Insforge实例URL（如果与默认值不同）。

手动配置： 如果您的MCP客户端支持手动配置MCP服务器，请将以下JSON片段添加到您的MCP设置文件中：

{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": [
        "-y",
        "@insforge/mcp@latest"
      ],
      "env": {
        "API_KEY": "your_insforge_api_key",
        "API_BASE_URL": "your_insforge_base_url"
      }
    }
  }
}

'"insforge"': 这是您为该MCP服务器定义的唯一名称。
'"command": "npx"': 这是用于启动MCP服务器的程序命令，'npx' 用于运行Node.js包。
'"args": ["-y", "@insforge/mcp@latest"]': 这是传递给 'npx' 命令的参数，指示其运行最新版本的 '@insforge/mcp' 包。
'"env"': 这里定义了MCP服务器运行时所需的特定环境变量：
- '"API_KEY": "your_insforge_api_key"': 您的Insforge平台API密钥，用于认证对Insforge后端的所有请求。
- '"API_BASE_URL": "your_insforge_base_url"': 您的Insforge后端服务的URL地址，例如 'http://localhost:7130'。

基本使用方法

配置完成后，您的大型语言模型客户端将能够发现并调用Insforge MCP服务提供的各种工具。LLM会根据您的对话指令和上下文，智能地选择并执行最合适的工具。

例如：

当您需要了解某个数据库表的结构时，LLM可以调用 'get-table-schema' 工具并指定表名，然后获取详细的表定义。
当您想创建新的云存储空间时，LLM可以调用 'create-bucket' 工具并提供桶名称和访问权限。
当您需要部署或更新自定义代码逻辑到Insforge平台时，LLM可以调用 'create-function' 或 'update-function' 工具，指定函数名称和代码文件路径。
在调试应用程序时，LLM可以请求 'get-container-logs' 工具来检索相关服务的最新日志信息。

LLM将通过这些工具参数与Insforge后端进行交互，实现数据查询、修改、资源管理和函数部署等多种操作，而无需用户直接编写代码或调用API。

关键词

项目简介

主要功能点

安装步骤

基本使用方法

信息