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