🤖 MCPServe by @ryaneggz

Name: 🤖 MCPServe by @ryaneggz
Author: ryaneggz

@ryaneggz

リポジトリホームページ

🤖 MCPServe by @ryaneggz について

🔌🔄 Simple MCP Server Deployment

#docker #ubuntu #mcp #container #gemini #openai #ngrok #claude #sonnet #langchain #anthropic #deepseek #langgraph #modelcontextprotocol #vibecoding

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

ryaneggz

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcpserve": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is 🤖 MCPServe by @ryaneggz?

🤖 MCPServe by @ryaneggz is a simple MCP (Model Context Protocol) server with shell execution capabilities. It can be hosted locally, connected to via Ngrok, or deployed as a Docker container running Ubuntu 24. It is designed for developers who need an MCP server that can execute shell commands remotely.

How to use 🤖 MCPServe by @ryaneggz?

Install uv, create a virtual environment, install dependencies from requirements.txt, and start the server with python main.py. For Docker, run docker compose up --build. Configure your MCP client with the SSE transport URL http://localhost:8005/sse and optionally add an x-api-key header if server-side authentication is enabled.

Key features of 🤖 MCPServe by @ryaneggz

Simple MCP server with shell execution
Local hosting via Python or Docker
Ngrok support for remote access
SSE (Server-Sent Events) transport
Optional API key authentication header

Use cases of 🤖 MCPServe by @ryaneggz

Remotely execute shell commands through an MCP client
Set up a local development environment for testing MCP tools
Deploy a containerized MCP server for production or cloud use

FAQ from 🤖 MCPServe by @ryaneggz

What dependencies are required?

Python, uv (install script provided), and the packages listed in requirements.txt. For Docker, Docker and Docker Compose are needed.

How do I configure an MCP client?

Use a JSON config with "transport": "sse" and "url": "http://localhost:8005/sse". Optionally add "headers": { "x-api-key": "your-key" } if authentication is enabled server-side.

Can I run the server without Docker?

Yes. You can install uv, create a virtual environment, install dependencies, and run python main.py directly on your local machine.

What transport protocol does it use?

It uses SSE (Server-Sent Events) transport, as shown in the client configuration example.

Is authentication supported?

An optional x-api-key header can be added in the client config, but the README notes this requires code changes to the MCP library’s settings to work properly.