ValTown MCP Server

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          # Builds for all platforms
   deno task build:linux    # Builds only for Linux
   deno task build:windows  # Builds only for Windows
   deno task build:macos    # Builds only for macOS
   

选项 3：直接使用 Deno 运行

deno task start  # Run the server
deno task dev    # Run the server with watch mode for development

配置

此服务需要 ValTown API 令牌才能运行。请设置以下环境变量：

• VAL_TOWN_API_TOKEN：你的 ValTown API 令牌（以 vtwn_ 开头）

你可以在 ValTown 账户设置中获取 ValTown API 令牌。

在 MCP 客户端中使用

在线连接（托管在 ValTown 上）

使用此 MCP 服务最简单的方式是连接到托管在 ValTown 上的版本：

{
  "mcpServers": {
    "valtown": {
      "type": "streamable-http",
      "url": "https://prashamtrivedi-valtown-mcp-server.val.run/mcp",
      "headers": {
        "x-val-town-token": "YOUR_VAL_TOWN_TOKEN_HERE"
      }
    }
  }
}

将 YOUR_VAL_TOWN_TOKEN_HERE 替换为你的实际 ValTown API 令牌。

本地安装

如果你希望在本地运行此服务，可以使用以下方法：

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"
  }
}

使用 Deno 运行（所有平台）

如果已安装 Deno，可以直接运行此服务：

"valtown": {
  "command": "deno",
  "args": ["run", "--allow-net", "--allow-env", "--allow-read", "/path/to/mod.ts"],
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

Claude Code

使用 CLI 将 ValTown MCP 服务添加到 Claude Code：

claude mcp add valtown /path/to/valtown-mcp-linux -e VAL_TOWN_API_TOKEN=vtwn_KEY

在 Windows 上，使用：

claude mcp add valtown C:\path\to\valtown-mcp-windows.exe -e VAL_TOWN_API_TOKEN=vtwn_KEY

在 macOS 上，使用：

claude mcp add valtown /path/to/valtown-mcp-macos -e VAL_TOWN_API_TOKEN=vtwn_KEY

其他兼容 MCP 的客户端

对于其他兼容 MCP 的客户端，请将其配置为指向 ValTown MCP 服务二进制文件，并确保已设置 VAL_TOWN_API_TOKEN 环境变量。

故障排除

• 确保 ValTown API 令牌有效
• 检查服务是否可以访问网络
• 确认二进制文件已设置正确的权限（Linux/macOS 可能需要执行 chmod +x）

贡献

欢迎贡献！请随时提交 Pull Request。

更新日志

请参阅 CHANGELOG，了解此项目的重要变更。

许可证

此项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。