Backend - MCP Server

This directory contains the MCP (Model Context Protocol) server implementation that exposes Val Town's native capabilities.

Structure

  • index.ts - Main HTTP server entry point
  • mcp/ - MCP protocol implementation
    • server.ts - Core MCP request/response handling
    • tools.ts - Tool definitions and execution handlers
    • resources.ts - Resource discovery and reading
    • types.ts - TypeScript type definitions for MCP protocol

MCP Protocol Methods

Core Methods

  • initialize - Initialize the MCP session
  • ping - Health check

Tools

  • tools/list - List available tools
  • tools/call - Execute a tool

Resources

  • resources/list - List available resources
  • resources/read - Read a resource

Available Tools

  1. Blob Storage

    • blob_get - Retrieve blob data
    • blob_set - Store blob data
    • blob_list - List blob keys
    • blob_delete - Delete blob
  2. SQLite Database

    • sqlite_execute - Execute SQL queries
  3. Email

    • email_send - Send emails
  4. OpenAI

    • openai_chat - Generate text with OpenAI
  5. File Operations

    • file_read - Read project files
    • file_list - List project files
  6. Environment

    • env_get - Get environment variables (names only for security)

Available Resources

  • blob://[key] - Blob storage items
  • file://[path] - Project files
  • sqlite://schema - Database schema
  • env://info - Environment variable info