Knmurphy Glide Api MCP Server

🚀 Glide API MCP 服务器

Glide API MCP 服务器是一个用于与 Glide API（v1 和 v2）交互的 Model Context Protocol 服务器，它能帮助开发者更便捷地与 Glide API 进行交互，提升开发效率。

🚀 快速开始

在开始使用 Glide API MCP 服务器之前，你需要进行开发环境的搭建。首先安装依赖项：

npm install

接着构建服务器：

npm run build

若你需要在开发过程中实现自动重建，可以使用以下命令：

npm run watch

✨ 主要特性

• 多版本支持：支持 Glide API v1 和 v2，满足不同版本的使用需求。
• 安全密钥处理：通过环境变量实现安全的 API 密钥处理，保障密钥安全。
• 类型安全：采用类型安全的 TypeScript 实现，减少类型相关的错误。
• 全面错误处理：具备全面的错误处理机制，让开发过程更加稳定。

📦 安装指南

安装依赖项：

npm install

构建服务器：

npm run build

带有自动重建的开发：

npm run watch

💻 使用示例

基础用法

1. 获取应用程序信息

use_mcp_tool({
  server_name: "glide-api",
  tool_name: "get_app",
  arguments: {
    appId: "your-app-id"
  }
});

2. 添加表格行

use_mcp_tool({
  server_name: "glide-api",
  tool_name: "add_table_row",
  arguments: {
    appId: "your-app-id",
    tableId: "your-table-id",
    values: {
      column1: "value1",
      column2: "value2"
    }
  }
});

高级用法

目前文档中未提供高级用法相关内容，若有后续补充，可进一步参考。

📚 详细文档

可用工具

• set_api_version：配置 API 版本和身份验证
• get_app：获取应用程序信息
• get_tables：列出应用程序表格
• get_table_rows：获取表数据
• add_table_row：添加新行
• update_table_row：更新现有行

安全设置

1. 环境变量

该服务器通过 MCP 设置文件中的环境变量支持安全配置。将您的 API 凭证添加到 MCP 设置文件中：

{
  "mcpServers": {
    "glide-api": {
      "command": "node",
      "args": ["path/to/build/index.js"],
      "env": {
        "GLIDE_API_KEY": "your-api-key-here",
        "GLIDE_API_VERSION": "v2"  // 或 "v1" 使用 v1 API
      }
    }
  }
}

此方法通过以下方式保持 API 密钥的安全：

• 将其存储在配置文件中而不是代码中
• 避免将其纳入版本控制
• 使其易于更新而不修改代码

2. 运行时配置

尽管环境变量是推荐的配置方式，您也可以使用 set_api_version 工具在运行时设置或覆盖 API 版本和密钥：

use_mcp_tool({
  server_name: "glide-api",
  tool_name: "set_api_version",
  arguments: {
    version: "v2",
    apiKey: "your-api-key"
  }
});

注意：运行时配置将覆盖当前会话中的任何环境变量。

3. 安全最佳实践

1. 永远不要将 API 密钥提交到版本控制
2. 使用环境变量在 MCP 设置文件中
3. 定期轮换您的 API 密钥
4. 设置适当文件权限在设置文件上

开发

安装依赖项：

npm install

构建服务器：

npm run build

带有自动重建的开发：

npm run watch

🔧 技术细节

该服务器采用 TypeScript 实现，具有类型安全的特性。通过环境变量和运行时配置的方式，保障 API 密钥的安全。在开发过程中，使用 npm install 安装依赖，npm run build 构建服务器，npm run watch 实现带有自动重建的开发。同时，提供了一系列工具用于与 Glide API 进行交互，如 set_api_version、get_app 等，并且具备全面的错误处理机制，确保服务器的稳定运行。