{"id":29113569,"url":"https://github.com/theailanguage/terminal_server","last_synced_at":"2025-06-29T11:07:29.069Z","repository":{"id":281349277,"uuid":"945009126","full_name":"theailanguage/terminal_server","owner":"theailanguage","description":"MCP server that can execute terminal commands","archived":false,"fork":false,"pushed_at":"2025-06-21T07:03:49.000Z","size":31,"stargazers_count":36,"open_issues_count":1,"forks_count":16,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-06-21T08:19:05.454Z","etag":null,"topics":["claude-desktop","docker","mcp-server","terminal"],"latest_commit_sha":null,"homepage":"https://youtu.be/_veLqeCzdIQ","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theailanguage.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-08T12:53:14.000Z","updated_at":"2025-06-21T07:03:52.000Z","dependencies_parsed_at":"2025-04-04T21:29:40.943Z","dependency_job_id":null,"html_url":"https://github.com/theailanguage/terminal_server","commit_stats":null,"previous_names":["theailanguage/terminal_server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/theailanguage/terminal_server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theailanguage%2Fterminal_server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theailanguage%2Fterminal_server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theailanguage%2Fterminal_server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theailanguage%2Fterminal_server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theailanguage","download_url":"https://codeload.github.com/theailanguage/terminal_server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theailanguage%2Fterminal_server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262581374,"owners_count":23331913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-desktop","docker","mcp-server","terminal"],"created_at":"2025-06-29T11:05:39.911Z","updated_at":"2025-06-29T11:07:29.044Z","avatar_url":"https://github.com/theailanguage.png","language":"Python","funding_links":[],"categories":["Command Line"],"sub_categories":[],"readme":"# MCP SSE Server and STDIO Server Examples\n\n## Introduction\n\nWelcome 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.\n\n### Available Server Examples\nWe provide four examples to help you set up your MCP server in different environments. The table below summarizes each configuration:\n\n| Example | Server Type | Transport Method | Environment | Docker | Tutorial Link |\n|---------|-------------|------------------|-------------|--------|---------------|\n| 1 | **Terminal Server (STDIO)** | STDIO | Local | No | [Tutorial 1](https://youtu.be/_veLqeCzdIQ) |\n| 2 | **Terminal Server (STDIO)** | STDIO | Local | Yes | [Tutorial 2](https://youtu.be/cgml6yzrOjc) |\n| 3 | **Terminal Server (SSE)** | SSE | Local | Yes | [Tutorial 3](https://youtu.be/s0YJNcT1XMA) |\n| 4 | **Terminal Server (SSE)** | SSE | Google Cloud Platform (Web) | Yes | [Tutorial 3](https://youtu.be/s0YJNcT1XMA) |\n\nIf 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!  \n[SUBSCRIBE](https://youtube.com/@theailanguage?sub_confirmation=1)\n\n## What is MCP?\n\n**MCP (Model Context Protocol)** is a protocol that allows AI models to:\n- **Store data** (like files or API responses)\n- **Run tools** (functions that AI can execute)\n- **Use prompts** (predefined templates for tasks)\n\n---\n\n## Option 1: Setup Without Docker (Local Python)\n\nThis option demonstrates how to set up an MCP server locally using Python without Docker. Follow the video tutorial: [Tutorial 1](https://youtu.be/_veLqeCzdIQ)\n\n---\n\n## Option 2: Setup With Docker\n\nThis option shows how to containerize the MCP server with Docker and run it locally. Follow the video tutorial: [Tutorial 2](https://youtu.be/cgml6yzrOjc)\n\n---\n\n## Option 3: Setup with SSE (Local, Docker)\n\nThis option demonstrates how to run an MCP server over SSE using Docker in a local environment. Follow the video tutorial: [Tutorial 3](https://youtu.be/s0YJNcT1XMA)\n\n---\n\n## Option 4: Setup with SSE on Google Cloud Platform\n\nThis option details how to deploy the SSE server to Google Cloud Platform using Docker. Follow the video tutorial: [Tutorial 3](https://youtu.be/s0YJNcT1XMA)\n\n---\n\n## Testing the MCP Server\n\nOnce the server is running, you can test it by using prompts in Claude, such as:\n\n- `Run the command ls in my workspace.`\n- `Execute echo Hello from Claude.`\n\nYou should see the output directly from your terminal server 🎉\n\n---\n\n## Wrapping Up\n\nCongrats! You've successfully built an MCP server that can execute terminal commands. You can run it locally or in Docker, depending on your preference.\n\n### Next Steps:\n- Add security checks to block potentially dangerous commands.\n- Allow Claude to read and write files.\n- Connect the server to cloud systems or remote environments.\n\nFor any issues or improvements, feel free to contribute and open an issue or pull request in this repository!\n\n## 🤝 Contributing\n\nAt this time, this project does **not accept external code contributions**.\n\nThis is to keep licensing simple and avoid any shared copyright.\n\nYou're very welcome to:\n✅ Report bugs or request features (via GitHub Issues)  \n✅ Fork the repo and build your own version  \n✅ Suggest documentation improvements\n\nIf you'd like to collaborate in another way, feel free to open a discussion!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheailanguage%2Fterminal_server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheailanguage%2Fterminal_server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheailanguage%2Fterminal_server/lists"}