Valtown MCP Server

🚀 ValTown MCP 服務器

ValTown MCP 服務器是專門為 ValTown 開發的模型上下文協議（MCP）服務器，它能讓 AI 助手在 ValTown 環境中執行代碼，為開發者提供了便捷高效的代碼執行方案。

✨ 主要特性

• 可在 AI 助手中執行 ValTown 函數。
• 兼容所有 MCP 客戶端，如 Claude Desktop、Claude Code 等。
• 支持多平臺，包括 Windows、macOS、Linux。

📦 安裝指南

選項 1：使用預編譯二進制文件

您可以從 最新版本 下載適用於您平臺的適當二進制文件：

• Linux：valtown-mcp-linux
• Windows：valtown-mcp-windows.exe
• macOS：valtown-mcp-macos

選項 2：從源碼構建

1. 安裝 Deno。
2. 克隆此倉庫。
3. 構建二進制文件：

deno task build          # 為所有平臺構建
deno task build:linux    # 只為 Linux 構建
deno task build:windows  # 只為 Windows 構建
deno task build:macos    # 只為 macOS 構建

選項 3：直接使用 Deno 運行

deno task start  # 運行服務器
deno task dev    # 開發模式運行服務器（帶觀察功能）

📚 詳細文檔

配置

服務器需要一個 ValTown API 令牌才能運行。您需要設置以下環境變量：

• VAL_TOWN_API_TOKEN：您的 ValTown API 令牌（以 vtwn_ 開頭）

您可以在 ValTown 賬戶設置 中獲取 ValTown API 令牌。

與 MCP 客戶端配合使用

Claude Desktop

• Windows 配置：在您的 Claude Desktop 配置中添加以下內容：

"valtown": {
  "command": "C:\\path\\to\\valtown-mcp-windows.exe",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

• macOS 配置：在您的 Claude Desktop 配置中添加以下內容：

"valtown": {
  "command": "/path/to/valtown-mcp-macos",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

• Linux 配置：在您的 Claude Desktop 配置中添加以下內容：

"valtown": {
  "command": "/path/to/valtown-mcp-linux",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

其他 MCP 客戶端

根據具體客戶端的文檔進行配置，通常需要指定命令和環境變量。

故障排除

• 確保已正確設置 VAL_TOWN_API_TOKEN 環境變量。
• 檢查是否有足夠的權限運行服務器。
• 查看日誌以獲取更多信息。

貢獻

歡迎貢獻代碼或文檔！請參考倉庫中的 CONTRIBUTING.md 文件。

變更日誌

變更記錄將在 RELEASES 中發佈。