Skip to main content
Glama
senkuboy0-cyber

Spark Terminal MCP

by senkuboy0-cyber
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Hybrid

Spark Terminal MCP

A Gemini Spark-compatible MCP server with 30+ terminal tools — deployed on Render.

What this is

Gemini Spark requires custom Connected Apps to expose a full OAuth 2.1 discovery chain before it will call any tools:

Spec

Endpoint

Purpose

RFC 9728

/.well-known/oauth-protected-resource

Discover which auth server protects the tools

RFC 8414

/.well-known/oauth-authorization-server

Find token/registration/authorize endpoints

RFC 7591

/api/oauth/register

Dynamic Client Registration (auto-register)

RFC 7636

/authorize + /api/oauth/token

PKCE authorization-code flow

This server implements all four, plus the Streamable HTTP MCP transport that Spark uses.

Related MCP server: cloudflare-mcp-dcr-bridge

Tools (30+)

Group

Tools

Command Execution

execute_command, run_python_code, stream_output, get_process_output, kill_process

File Management

read_file, write_file, delete_file, move_file, copy_file, list_directory, create_directory

Web & Internet

fetch_url, download_file_from_url, search_web, http_request

Package & System

install_package, get_system_info, list_processes, check_disk_space, view_logs

Text Processing

grep_file, find_files, replace_in_file

Git

git_clone, git_status, git_commit, git_push, git_pull

Archive

compress_files, extract_archive

Network

ping_host, check_port, get_ip_info

System

change_permissions, get_env_variable, set_env_variable

Downloads

get_download_url, clear_terminal

Deploy to Render

  1. Fork / clone this repo

  2. Go to render.com → New → Web Service

  3. Connect this repo, select Docker runtime

  4. Set env var JWT_SIGNING_KEY to a random 64-char hex string

  5. Deploy — get your https://spark-terminal-mcp.onrender.com URL

Connect to Gemini Spark

  1. Go to gemini.google.com

  2. Switch to Spark mode

  3. Settings & help → Connected Apps → Add a custom app

  4. Enter your Render URL: https://spark-terminal-mcp.onrender.com

  5. Follow OAuth flow — click Connect

Local dev

pip install -r requirements.txt
AUTH_BYPASS=true python3 server.py
# Server on http://localhost:8080
# MCP endpoint: http://localhost:8080/mcp

Environment variables

Variable

Default

Description

PORT

8080

HTTP port

AUTH_BYPASS

false

Set true to skip auth (local dev only)

JWT_SIGNING_KEY

auto-generated

Secret for signing JWT tokens

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • cloudflare-mcp-dcr-bridge

    jerryscy
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables Gemini Enterprise to connect to Cloudflare Zero Trust MCP server portals via Dynamic Client Registration (DCR) and OAuth 2.0 proxying. It proxies MCP JSON-RPC/SSE traffic with Cloudflare Access service token authentication.
    MIT

  • mcp-gateway

    R0Wi
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables clients to access multiple backend MCP servers through a single endpoint, with OAuth 2.1 authorization, namespaced tools, and secure credential management.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/senkuboy0-cyber/spark-terminal-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server