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:从源代码构建
- 安装 德诺
- 克隆此存储库
- 构建二进制文件:
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许可证获得许可-请参阅 许可证 文件 了解详情。
