ValTown MCP 服务器

ValTown MCP 服务器是一个允许AI助手在ValTown环境中执行代码的模型上下文协议服务器,适用于跨平台开发和AI辅助编程。

  • by PrashamTrivedi
  • TypeScript
  • 混合部署
  • 15 星标
  • 更新于
在 GitHub 查看 PrashamTrivedi/valtown-mcp-server

使用说明

ValTown MCP服务器

一种模型上下文协议(MCP)服务器 瓦尔敦 那 允许AI助手在ValTown环境中执行代码。

特性

  • 通过AI助手执行ValTown功能
  • 兼容所有MCP客户端(克劳德桌面、克劳德代码等)
  • 跨平台支持(Windows、macOS、Linux)

安装

选项1:使用预构建的二进制文件

从以下网址下载适用于您平台的二进制文件 最新版本:

  • Linux: valtown-mcp-linux
  • 窗户: valtown-mcp-windows.exe
  • macOS: valtown-mcp-macos

选项2:从源代码构建

  1. 安装 德诺
  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帐户设置.

与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代币。

本地安装

如果您更喜欢在本地运行服务器,可以使用以下方法:

克劳德桌面

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

克劳德代码

使用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)

贡献

欢迎投稿!请随时提交拉取请求。

更新日志

请参阅 更新日志 查看此项目的显著更改列表。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件 了解详情。