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 中发布。