Scenic MCP

MCP (Model Context Protocol) server for Scenic Elixir applications. This enables AI-driven automation and testing of any Scenic app.

Architecture

This project consists of two parts:

Elixir Library - A TCP server that runs inside your Scenic app
MCP Server - A TypeScript/Node.js server that implements the MCP protocol

Your Scenic App (Elixir)
    ↓ adds dependency
scenic_mcp (Elixir TCP Server on port 9999)
    ↓ TCP connection
scenic-mcp (TypeScript MCP Server)
    ↓ MCP protocol
AI Assistant (Claude, Cline, etc.)

Quick Start

1. Add to your Scenic app

Add scenic_mcp to your dependencies in mix.exs:

defp deps do
  [
    {:scenic, "~> 0.11"},
    {:scenic_mcp, path: "../scenic_mcp"}  # or from hex/git when published
  ]
end

The TCP server will automatically start when your app starts.

2. Install the MCP server

For development (from this repo):

cd scenic_mcp
npm install
npm run build

For end users (when published):

npm install -g @scenic/mcp-server

3. Configure your MCP client

Add to your MCP client configuration (e.g., Claude Desktop, Cline):

{
  "mcpServers": {
    "scenic": {
      "command": "node",
      "args": ["/path/to/scenic_mcp/dist/index.js"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "scenic": {
      "command": "scenic-mcp"
    }
  }
}

Testing

Test the Elixir TCP server:

# Start your Scenic app with scenic_mcp
cd your_scenic_app
iex -S mix

# In another terminal, test the TCP connection
echo "hello" | nc localhost 9999

You should see a JSON response with Elixir system info.

Test the MCP integration:

Start your Scenic app
Make sure the MCP server is configured in your client
Use the hello_scenic tool to test the connection

Development

Project Structure

scenic_mcp/
├── lib/                    # Elixir source
│   ├── scenic_mcp.ex
│   └── scenic_mcp/
│       ├── application.ex
│       └── server.ex
├── src/                    # TypeScript source
│   └── index.ts
├── dist/                   # Compiled JavaScript
├── mix.exs                 # Elixir package
└── package.json            # Node package

Building

# Install Elixir deps
mix deps.get

# Install Node deps
npm install

# Build TypeScript
npm run build

# Bundle for local dev
npm run bundle

Current Features

✅ Basic TCP server in Elixir
✅ MCP server in TypeScript
✅ Hello world communication test

Roadmap

Viewport discovery and management
Input injection (click, type, etc.)
Screenshot capture
Scene navigation
Element inspection
Custom app-specific tools

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

A Model Context Protocol server that enables AI-driven automation and testing of Scenic Elixir applications through a TCP connection.

Related MCP Servers

ConnectWise API Gateway MCP Server
jasondsmith72
-
security
F
license
-
quality
A Model Context Protocol server that provides a comprehensive interface for interacting with the ConnectWise Manage API, simplifying API discovery, execution, and management for both developers and AI assistants.
Last updated -
46
2
Python
MCP Server Demo
tian1ll1
-
security
F
license
-
quality
A demonstration implementation of the Model Context Protocol server that facilitates communication between AI models and external tools while maintaining context awareness.
Last updated -
Python
MCP Server For Local
Dreamboat-Rachel
-
security
A
license
-
quality
A customizable Model Context Protocol server implementation that enables AI models to interact with external tools including weather queries, Google search, and camera control functionality.
Last updated -
8
Python
Apache 2.0
Emacs MCP Server
vivekhaldar
-
security
-
license
-
quality
A Model Context Protocol server that enables generating and executing Elisp code in a running Emacs process, allowing AI assistants to control and interact with Emacs.
Last updated -
Python

View all related MCP servers

Scenic MCP

Scenic MCP

Architecture

Quick Start

1. Add to your Scenic app

2. Install the MCP server

3. Configure your MCP client

Testing

Test the Elixir TCP server:

Test the MCP integration:

Development

Project Structure

Building

Current Features

Roadmap

License

Related MCP Servers

ConnectWise API Gateway MCP Server

MCP Server Demo

MCP Server For Local

Emacs MCP Server

New MCP Servers

MCP directory API