Latitudesh MCP

Latitude.sh MCP服务器

模型上下文协议（MCP）服务器 Latitude.sh API

概述

Latitude.sh MCP服务器将您的Latitude.sh REST API公开为AI就绪接口，允许开发人员工具和助手以编程方式列出、创建和管理基础设施资源。

使用自然语言：

• 🔎 列出并检查服务器、项目和SSH密钥
• ⚙️ 创建或删除裸机实例
• 📡 直接从基于聊天的IDE管理网络和自动化

安装

🪶 先决条件：你需要一个 Latitude.sh API密钥.

DXT (Desktop Extension)

使用预构建的作为桌面扩展安装MCP服务器 mcp-server.dxt 文件：

只需拖放 mcp-server.dxt 将文件安装到Claude Desktop上以安装扩展。

DXT包包括MCP服务器和所有必要的配置。安装后，服务器将无需额外设置即可使用。

\[！注意\] DXT（桌面扩展）提供了一种简化的方式来打包和分发MCP服务器。更多了解 桌面扩展.

Cursor

1. 打开光标设置
2. 选择工具和集成
3. 选择新MCP服务器
4. 将以下JSON粘贴到MCP服务器配置中：

{
  "mcpServers": {
    "Latitudesh": {
      "command": "npx",
      "args": [
        "latitudesh",
        "start",
        "--bearer",
        ""
      ]
    }
  }
}

注： 替换 YOUR_LATITUDE_API_TOKEN 使用您实际的Latitude.sh持有者代币。

Claude Code CLI

claude mcp add latitudesh npx latitudesh start -- --bearer YOUR_LATITUDE_API_TOKEN

注： 替换 YOUR_LATITUDE_API_TOKEN 使用您实际的Latitude.sh持有者代币。

Windsurf

参见 官方Windsurf文档 获取最新信息

1. 打开风帆设置
2. 在左侧菜单中选择Cascade
3. 点击 Manage MCPs（要管理MCP，您应该使用Windsurf帐户登录）
4. 点击 View raw config 打开mcp配置文件。
5. 如果配置文件为空，请粘贴完整的json

{
  "mcpServers": {
    "Latitudesh": {
      "command": "npx",
      "args": [
        "latitudesh",
        "start",
        "--bearer",
        ""
      ]
    }
  }
}

VS Code

参见 官方VS Code文档 获取最新信息

1. 打开 命令面板
2. 搜索并打开 MCP: Open User Configuration。这应该会打开mcp.json文件
3. 如果配置文件为空，请粘贴完整的json

{
  "mcpServers": {
    "Latitudesh": {
      "command": "npx",
      "args": [
        "latitudesh",
        "start",
        "--bearer",
        ""
      ]
    }
  }
}

Claude Desktop Claude Desktop doesn't yet support SSE/remote MCP servers.

您需要执行以下操作

1. 打开克劳德桌面
2. 打开左侧窗格，然后单击您的用户名
3. 首选 Settings
4. 首选 Developer 选项卡（左侧）
5. 点击 Edit Config

将以下配置粘贴到配置中

{
  "mcpServers": {
    "Latitudesh": {
      "command": "npx",
      "args": [
        "latitudesh",
        "start",
        "--bearer",
        ""
      ]
    }
  }
}

注： 替换 YOUR_LATITUDE_API_TOKEN 使用您实际的Latitude.sh持有者代币。

VS Code

参见 官方VS Code文档 获取最新信息

1. 打开 命令面板 (Cmd+Shift+P / Ctrl+Shift+P)
2. 搜索并打开 MCP: Open User Configuration 打开mcp.json文件
3. 添加配置：

{
  "servers": {
    "Latitudesh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "latitudesh",
        "start",
        "--bearer",
        "YOUR_LATITUDE_API_TOKEN"
      ]
    }
  }
}

1. 保存文件并重新启动VS Code
2. 打开Copilot聊天(Cmd+Alt+I / Ctrl+Alt+I)并启用 代理模式
3. Latitudesh工具将自动可用

注： 替换 YOUR_LATITUDE_API_TOKEN 使用您实际的Latitude.sh持有者代币。

使用VS Code的提示：

• 在提示中明确：“从Latitude.sh列出我的服务器”，而不仅仅是“列出服务器”
• 提及“Latitude.sh”或“MCP”以避免Copilot搜索本地文件

Claude Desktop

1. 打开克劳德桌面
2. 点击左侧边栏中的用户名
3. 首选 Settings → Developer 标签
4. 点击 Edit Config
5. 添加配置：

{
  "mcpServers": {
    "Latitudesh": {
      "command": "npx",
      "args": [
        "latitudesh",
        "start",
        "--bearer",
        "YOUR_LATITUDE_API_TOKEN"
      ]
    }
  }
}

1. 保存并重新启动Claude Desktop

注： 替换 YOUR_LATITUDE_API_TOKEN 使用您实际的Latitude.sh持有者代币。

Standalone CLI Usage

要直接启动MCP服务器：

npx latitudesh start --bearer YOUR_LATITUDE_API_TOKEN

可选标志：

• --server-index -选择服务器（0=https://api.latitude.sh1.http://api.latitude.sh)\[默认值：0\]
• --latitude-api-key -用于URL模板的API密钥
• --log-level -日志级别（调试|警告|信息|错误）\[默认值：信息\]

有关服务器参数的完整列表：

npx latitudesh --help

发展

在本地运行，不使用已发布的npm包：

1. 克隆此仓库
2. 跑 npm install
3. 跑 npm run build
4. 跑 node ./bin/mcp-server.js start --bearer

要将此本地版本用于MCP客户端，您需要添加以下配置：

{
  "mcpServers": {
    "Latitudesh": {
      "command": "node",
      "args": [
        "/absolute/path/to/latitudesh-mcp/bin/mcp-server.js",
        "start",
        "--bearer",
        ""
      ]
    }
  }
}

本地调试

使用官方 MCP检查员:

npx @modelcontextprotocol/inspector node ./bin/mcp-server.js start --bearer 

这将在以下位置打开一个交互式UIhttp://localhost:6274.

🤝 贡献

虽然我们欢迎贡献，但大部分代码都是自动生成的。重新生成时，对生成文件的手动编辑将被覆盖。

如果您想提出改进建议：

• 用你的概念证明打开一个问题或公关
• 我们将对其进行审查，并在可能的情况下将其纳入未来的版本中

摘要

Latitude.sh API：Latitude.sh API是一个RESTful API，用于管理您的Latitude-sh帐户。它允许您执行与Latitude.sh仪表板相同的操作。

目录

• Latitude.sh MCP服务器

- 概述 - 安装 - 发展 - 🤝 贡献 - 安装 - 渐进式发现

安装

Claude Desktop

使用预构建的作为桌面扩展安装MCP服务器 mcp-server.mcpb 文件：

只需拖放 mcp-server.mcpb 将文件安装到Claude Desktop上以安装扩展。

MCP捆绑包包括MCP服务器和所有必要的配置。安装后，服务器将无需额外设置即可使用。

\[！注意\] MCP捆绑包提供了一种简化的方式来打包和分发MCP服务器。更多了解 桌面扩展.

Cursor

或手动：

1. 打开光标设置
2. 选择工具和集成
3. 选择新MCP服务器
4. 如果配置文件为空，请将以下JSON粘贴到MCP服务器配置中：

{
  "command": "npx",
  "args": [
    "latitudesh",
    "start",
    "--server-index",
    "0",
    "--latitude-api-key",
    "",
    "--bearer",
    ""
  ]
}

Claude Code CLI

claude mcp add Latitudesh -- npx -y latitudesh start --server-index 0 --latitude-api-key  --bearer 

Gemini

gemini mcp add Latitudesh -- npx -y latitudesh start --server-index 0 --latitude-api-key  --bearer 

Windsurf

参见 官方Windsurf文档 获取最新信息

1. 打开风帆设置
2. 在左侧菜单中选择Cascade
3. 点击 Manage MCPs（要管理MCP，您应该使用Windsurf帐户登录）
4. 点击 View raw config 打开mcp配置文件。
5. 如果配置文件为空，请粘贴完整的json

{
  "command": "npx",
  "args": [
    "latitudesh",
    "start",
    "--server-index",
    "0",
    "--latitude-api-key",
    "",
    "--bearer",
    ""
  ]
}

VS Code

或手动：

参见 官方VS Code文档 获取最新信息

1. 打开 命令面板
2. 搜索并打开 MCP: Open User Configuration。这应该会打开mcp.json文件
3. 如果配置文件为空，请粘贴完整的json

{
  "command": "npx",
  "args": [
    "latitudesh",
    "start",
    "--server-index",
    "0",
    "--latitude-api-key",
    "",
    "--bearer",
    ""
  ]
}

Stdio installation via npm To start the MCP server, run:

npx latitudesh start --server-index 0 --latitude-api-key  --bearer 

有关服务器参数的完整列表，请运行：

npx latitudesh --help

渐进式发现

具有许多工具的MCP服务器可能会使LLM上下文窗口膨胀，导致令牌使用增加和工具混乱。动态模式通过只公开一小部分元工具来解决这个问题，这些元工具让代理根据需要逐步发现和调用工具。

要启用动态模式，请传递 --mode dynamic 启动服务器时标记：

{
  "mcpServers": {
    "Latitudesh": {
      "command": "npx",
      "args": ["latitudesh", "start", "--mode", "dynamic"],
      // ... other server arguments
    }
  }
}

在动态模式下，服务器只注册以下元工具，而不是每个单独的工具：

• list_tools：列出所有可用工具及其名称和描述。
• describe_tool：按名称返回一个或多个工具的输入架构。
• execute_tool：使用提供的输入参数按名称执行工具。

这种方法显著减少了每次请求时发送到LLM的令牌数量，这对于具有大量工具的服务器特别有用。