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

1. 设置环境变量：

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

1. 运行服务器：

   python main.py

1. 使用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连接

贡献

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

许可证

麻省理工学院