AI导哈

API集成服务器

Skyvia MCP服务器是一个用于与Skyvia API交互的工具，专注于集成相关端点，支持管理工作区、连接和集成。

  • by xliberty2008x
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 xliberty2008x/skyvia-mcp-smithery

使用说明

Skyvia MCP服务器

一个模型上下文协议（MCP）服务器，用于通过API与Skyvia交互，重点关注与集成相关的端点。

概述

此MCP服务器提供与Skyvia API交互的工具，使您能够：

  • 管理工作区
  • 管理连接
  • 列出、查看和运行集成
  • 还有更多

该服务器被设计为部署在Smithery上，以便通过WebSocket连接轻松访问。

工具

工作区工具

  • list_workspaces：检索所有可用工作区
  • get_workspace：获取特定工作区的详细信息

连接工具

  • list_connections：列出工作区中的连接
  • get_connection_details：获取特定连接的详细信息
  • test_connection：测试连接

集成工具

  • list_integrations：列出工作区中的集成
  • get_integration：获取特定集成的详细信息
  • run_integration：执行集成

部署

先决条件

  • Docker已安装在本地计算机上
  • 访问Smithery部署
  • Skyvia API代币

局部测试

要在本地测试MCP服务器：

  1. 安装依赖项：

    pip install -r requirements.txt

  2. 设置环境变量：

    export SKYVIA_API_TOKEN="your-api-token-here"

  3. 运行服务器：

    python main.py

  4. 使用MCP Inspector等MCP客户端进行测试：

    npx @modelcontextprotocol/inspector python main.py

Smithery部署

  1. 将服务器添加到Smithery
  2. 使用Skyvia API令牌配置服务器
  3. 通过Smithery的界面部署和测试服务器

配置

服务器需要Skyvia API令牌才能通过Skyvia API进行身份验证。此令牌应通过以下方式提供 SKYVIA_API_TOKEN 环境变量。

使用示例

以下是一些工具的使用方法：

列出工作区

// Example MCP client code
const result = await client.useToolWithMCP("list_workspaces", {});
console.log(result);

列出集成

// Example MCP client code
const result = await client.useToolWithMCP("list_integrations", {
  workspace_id: 123 // Replace with your workspace ID
});
console.log(result);

运行集成

// Example MCP client code
const result = await client.useToolWithMCP("run_integration", {
  workspace_id: 123, // Replace with your workspace ID
  integration_id: 456 // Replace with your integration ID
});
console.log(result);

故障排除

“服务器未初始化”错误

如果您在尝试使用服务器工具时收到“服务器未初始化”错误，这通常表示由于缺少或无效的API令牌，服务器未正确初始化。要解决此问题，请执行以下操作：

  1. 验证您的Skyvia API令牌是否有效并具有必要的权限。
  2. 确保 SKYVIA_API_TOKEN 环境变量设置正确：
    • 对于本地测试，请使用 export SKYVIA_API_TOKEN="your-token-here"
    • 对于Smithery部署，请确保在Smithery配置文件中正确设置了令牌

诊断连接问题

该存储库包括一个用于测试连接的专用诊断脚本：

# Set your API token
export SKYVIA_API_TOKEN="your-token-here"

# Optionally set your Smithery API key (if using a different one)
export SMITHERY_API_KEY="your-smithery-api-key"

# Run the diagnostic script
python test_smithery_connection.py

此脚本将：

  • 测试与本地运行的服务器的直接连接
  • 测试与Smithery部署服务器的连接
  • 提供详细的日志和故障排除指导
  • 比较结果以帮助隔离问题是Smithery配置还是服务器本身

常见问题

  1. 缺少的依赖：确保您已安装了所有必需的软件包 pip install -r requirements.txt
  2. API令牌无效：令牌可能已过期或权限不足
  3. Smithery简介问题：如果使用Smithery，请使用API令牌检查您的配置文件是否具有正确的配置
  4. 网络问题：如果位于公司防火墙之后，请检查是否允许websocket连接

贡献

欢迎投稿！请随时提交拉取请求。

许可证

麻省理工学院

相关 MCP