Sandbox
@theailanguage/terminal_server

MCP server for terminal commands

This repo provides example MCP servers that let a connected agent execute terminal commands. It includes STDIO and SSE variants, with Docker-based setup options and a Claude Desktop configuration file.

89 stars30 forksPythonUpdated 1y ago
MCP Course #3 - Build MCP Server, here’s how
theailanguage9.2k views • 1 year ago

Videos about this repo

Who it's for

Builders who want an MCP server that can run shell commands from Claude Desktop or another MCP client.

What it delivers

You can let an agent execute commands like `ls` or `echo` in your terminal instead of copying them by hand.

What it does

STDIO terminal server

A local MCP server example that speaks over STDIO for terminal command execution.

SSE terminal server

A server variant that exposes the same idea over SSE for local or web deployment.

Docker setup

Dockerfiles for running the server locally or as a containerized service.

Claude Desktop config

A `claude_desktop_config.json` file for wiring the server into Claude Desktop.

README

MCP SSE Server and STDIO Server Examples

Introduction

Welcome to The AI Language project! In this repository, you'll find multiple examples of setting up MCP Servers. MCP (Model Context Protocol) is a framework for AI models that enables them to store data, run tools, and use prompts for specific tasks.

Available Server Examples

We provide four examples to help you set up your MCP server in different environments. The table below summarizes each configuration:

ExampleServer TypeTransport MethodEnvironmentDockerTutorial Link
1Terminal Server (STDIO)STDIOLocalNoTutorial 1
2Terminal Server (STDIO)STDIOLocalYesTutorial 2
3Terminal Server (SSE)SSELocalYesTutorial 3
4Terminal Server (SSE)SSEGoogle Cloud Platform (Web)YesTutorial 3

If you enjoy learning about AI, coding, and automation, please like and subscribe to the channel — it really helps us make more great content for you!
SUBSCRIBE

What is MCP?

MCP (Model Context Protocol) is a protocol that allows AI models to:

  • Store data (like files or API responses)
  • Run tools (functions that AI can execute)
  • Use prompts (predefined templates for tasks)

Option 1: Setup Without Docker (Local Python)

This option demonstrates how to set up an MCP server locally using Python without Docker. Follow the video tutorial: Tutorial 1


Option 2: Setup With Docker

This option shows how to containerize the MCP server with Docker and run it locally. Follow the video tutorial: Tutorial 2


Option 3: Setup with SSE (Local, Docker)

This option demonstrates how to run an MCP server over SSE using Docker in a local environment. Follow the video tutorial: Tutorial 3


Option 4: Setup with SSE on Google Cloud Platform

This option details how to deploy the SSE server to Google Cloud Platform using Docker. Follow the video tutorial: Tutorial 3


Testing the MCP Server

Once the server is running, you can test it by using prompts in Claude, such as:

  • Run the command ls in my workspace.
  • Execute echo Hello from Claude.

You should see the output directly from your terminal server 🎉


Wrapping Up

Congrats! You've successfully built an MCP server that can execute terminal commands. You can run it locally or in Docker, depending on your preference.

Next Steps:

  • Add security checks to block potentially dangerous commands.
  • Allow Claude to read and write files.
  • Connect the server to cloud systems or remote environments.

For any issues or improvements, feel free to contribute and open an issue or pull request in this repository!

🤝 Contributing

At this time, this project does not accept external code contributions.

This is to keep licensing simple and avoid any shared copyright.

You're very welcome to: ✅ Report bugs or request features (via GitHub Issues)
✅ Fork the repo and build your own version
✅ Suggest documentation improvements

If you'd like to collaborate in another way, feel free to open a discussion!

Files in the repo

Repository payload13 top-level entries
  • sse_server
  • streamable_http_server
  • .gitignore
  • .python-version
  • claude_desktop_config.json
  • Dockerfile
  • LICENSE.txt
  • main.py
  • pyproject.toml
  • README.md
  • requirements.txt
  • terminal_server.py
  • uv.lock

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k
t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k