photon

Overview

Photon is a development framework that allows developers to define functionality once in TypeScript and automatically expose it through multiple interfaces. It creates MCP servers for AI agents, CLI tools for automation, and web interfaces for humans. The framework reads TypeScript class methods, type annotations, and JSDoc comments to generate fully functional tools with validation, documentation, and UI components automatically. This approach reduces development overhead by eliminating the need to write separate implementations for different interfaces.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• forecastforecast(params: { city: string; days?: number })

  Get the weather forecast for a city

  Try:What's the weather forecast for London?Try:Get weather forecast for Tokyo for 3 days
• settings

  User-tunable configuration for the photon

  Try:Change the weather forecast units to imperialTry:Set the polling interval to 600 seconds
• convertconvert({ input, format }: { input: string; format: string })

  Convert video files using ffmpeg

  Try:Convert a video to mp4 formatTry:Convert input.avi to mkv

Comparable tools

Installation

bun add -g @portel/photon

photon new my-tool

photon mcp install my-tool

{
  "mcpServers": {
    "my-tool": {
      "command": "photon",
      "args": ["mcp", "my-tool"]
    }
  }
}

FAQ

What is Photon?

Photon is a framework that turns TypeScript files into MCP servers, CLI tools, and web interfaces automatically from a single codebase.

How does Photon differ from traditional MCP server development?

Photon eliminates the need to write boilerplate MCP server code, handle serialization, or create separate CLI and web interfaces - it generates everything automatically from your TypeScript definitions.

Compare photon with