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客户端

在线连接（托管于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。

更新日志

查看更新日志了解此项目的重大变更列表。

许可证

本项目采用MIT许可证 - 查看LICENSE文件了解详细信息。