Terminal MCP Server

by theailanguage
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables execution of shell commands in a dedicated workspace directory, returning command output or error messages to the AI

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!

-
security - not tested
F
license - not found
-
quality - not tested

An MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.

  1. Introduction
    1. Available Server Examples
  2. What is MCP?
    1. Option 1: Setup Without Docker (Local Python)
      1. Option 2: Setup With Docker
        1. Option 3: Setup with SSE (Local, Docker)
          1. Option 4: Setup with SSE on Google Cloud Platform
            1. Testing the MCP Server
              1. Wrapping Up
                1. Next Steps:
              2. 🤝 Contributing
                ID: 8dtoiu6ntq