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 等，並且具備全面的錯誤處理機制，確保服務器的穩定運行。