Valtown MCP Server

🚀 ValTown MCP Server

A Model Context Protocol (MCP) server developed for ValTown, allowing AI assistants to execute code in the ValTown environment.

🚀 Quick Start

This ValTown MCP Server enables AI assistants to execute code within the ValTown environment. You can follow the installation and configuration steps below to get started.

✨ Features

• Execute ValTown functions in AI assistants.
• Compatible with all MCP clients (Claude Desktop, Claude Code, etc.).
• Support multiple platforms (Windows, macOS, Linux).

📦 Installation

Option 1: Use pre - compiled binaries

Download the appropriate binary for your platform from the latest release:

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

Option 2: Build from source

1. Install Deno.
2. Clone this repository.
3. Build the binary:

   deno task build          # Build for all platforms
   deno task build:linux    # Build only for Linux
   deno task build:windows  # Build only for Windows
   deno task build:macos    # Build only for macOS
   

Option 3: Run directly with Deno

deno task start  # Run the server
deno task dev    # Run the server in development mode (with watch)

📚 Documentation

Configuration

The server requires a ValTown API token to run. Set the following environment variables:

• VAL_TOWN_API_TOKEN: Your ValTown API token (starting with vtwn_). You can obtain the ValTown API token in ValTown Account Settings.

Usage with MCP clients

Claude Desktop

Windows configuration

Add the following to your Claude Desktop configuration:

"valtown": {
  "command": "C:\\path\\to\\valtown-mcp-windows.exe",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

macOS configuration

Add the following to your Claude Desktop configuration:

"valtown": {
  "command": "/path/to/valtown-mcp-macos",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

Linux configuration

Add the following to your Claude Desktop configuration:

"valtown": {
  "command": "/path/to/valtown-mcp-linux",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

Other MCP clients

Configure according to the documentation of the specific client. Usually, you need to specify the command and environment variables.

Troubleshooting

• Ensure that the VAL_TOWN_API_TOKEN environment variable is set correctly.
• Check if you have sufficient permissions to run the server.
• Check the logs for more information.

Contribution

Contributions to the code or documentation are welcome! Please refer to the CONTRIBUTING.md file in the repository.

Changelog

Change logs will be published in RELEASES.