MCP Weather & DigitalOcean

MCP DigitalOcean

用于在 DigitalOcean App Platform 上部署和管理静态网站的模型上下文协议（MCP）服务。

项目结构

src/
├── index.ts              # Main entry point
├── shared/               # Shared utilities
│   └── api.ts            # Shared API utilities
├── digitalocean/         # DigitalOcean MCP server
│   ├── api.ts            # DigitalOcean API functions
│   ├── server.ts         # DigitalOcean MCP server configuration
│   └── types.ts          # DigitalOcean API types
└── template/             # Template for new MCP servers
    ├── api.ts            # Template API functions
    ├── server.ts         # Template MCP server configuration
    └── types.ts          # Template API types
tests/                    # Test scripts and files

可用的 MCP 服务

DigitalOcean 服务

DigitalOcean MCP 服务使用其 API 提供在 DigitalOcean App Platform 上部署和管理静态网站的工具。

API 令牌处理

DigitalOcean MCP 服务会按以下顺序自动查找 API 令牌：

1. 作为工具调用中的参数
2. 环境变量：DO_API_TOKEN 或 DIGITALOCEAN_API_TOKEN
3. ~/.dotoken 文件，其中仅包含令牌
4. 项目根目录中的 .env 文件，包含 DO_API_TOKEN=your_token
5. ~/.config/digitalocean/token 文件，其中仅包含令牌

这意味着你可以一次性设置令牌，无需在每次命令中提供。

工具：

• deploy-static-site：将静态网站部署到 DigitalOcean App Platform

  • 必需参数：
    • app_name：应用名称
    • repo：GitHub 存储库（username/repo）
  • 可选参数：
    • token：DigitalOcean API 令牌（如果已存储在环境变量或配置文件中，则可省略）
    • region：区域代码（例如 nyc、sfo）- 默认值："nyc"
    • branch：要部署的分支 - 默认值："main"
    • source_dir：存储库中包含源代码的目录 - 默认值："/"
    • build_command：构建命令（如需要）
    • output_dir：构建输出文件的目录
    • deploy_on_push：在 git push 时自动部署 - 默认值：true
    • environment_slug：运行时环境 - 默认值："html"
    • custom_domain：自定义域名（可选）

• get-app-info：获取有关 DigitalOcean App Platform 应用的信息

  • 必需参数：
    • app_id：应用 ID
  • 可选参数：
    • token：DigitalOcean API 令牌（如果已存储在环境变量或配置文件中，则可省略）

• get-deployment-status：获取特定部署的状态

  • 必需参数：
    • app_id：应用 ID
    • deployment_id：部署 ID
  • 可选参数：
    • token：DigitalOcean API 令牌（如果已存储在环境变量或配置文件中，则可省略）

• list-deployments：列出应用的所有部署

  • 必需参数：
    • app_id：应用 ID
  • 可选参数：
    • token：DigitalOcean API 令牌（如果已存储在环境变量或配置文件中，则可省略）

• create-deployment：创建新部署（重新部署应用）

  • 必需参数：
    • app_id：应用 ID
  • 可选参数：
    • token：DigitalOcean API 令牌（如果已存储在环境变量或配置文件中，则可省略）
    • force_build：不使用缓存，强制重新构建 - 默认值：false

• get-deployment-logs：获取部署日志

  • 必需参数：
    • app_id：应用 ID
    • deployment_id：部署 ID
  • 可选参数：
    • token：DigitalOcean API 令牌（如果已存储在环境变量或配置文件中，则可省略）

• delete-app：从 DigitalOcean App Platform 删除应用

  • 必需参数：
    • app_id：应用 ID
  • 可选参数：
    • token：DigitalOcean API 令牌（如果已存储在环境变量或配置文件中，则可省略）

添加新的 MCP 服务

添加新的 MCP 服务：

1. 复制 template 目录，并将其重命名为你的服务名称
2. 更新类型、API 函数和服务配置
3. 将你的服务添加到主 index.ts 文件中

构建和运行

# Install dependencies
npm install

# Build the project
npm run build

# Run the DigitalOcean MCP server
node build/index.js

测试

项目在 tests/ 目录中包含多个测试脚本：

• test-simple.mjs：向 MCP 服务发送 JSON-RPC 请求的简单测试脚本
• test-api.mjs：直接测试 DigitalOcean API 的脚本
• test-mcp.mjs：针对 MCP 服务的综合测试
• test-deploy.mjs：专门用于 deploy-static-site 工具的测试脚本
• token-test.mjs：用于验证能否正确读取 DigitalOcean API 令牌的实用脚本

运行测试：

# Run a test script
node tests/test-simple.mjs

Cursor 集成

若要与 Cursor 配合使用，请将以下内容添加到 .cursor/mcp.json 文件中：

{
  "mcpServers": {
    "digitalocean": {
      "command": "node",
      "args": [
        "/path/to/your/project/build/index.js"
      ]
    }
  }
}