README
🚀 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. 安全最佳实践
- 永远不要将 API 密钥提交到版本控制
- 使用环境变量在 MCP 设置文件中
- 定期轮换您的 API 密钥
- 设置适当文件权限在设置文件上
开发
安装依赖项:
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 等,并且具备全面的错误处理机制,确保服务器的稳定运行。
Scan to join WeChat group