OpenHands MCP Server

@jufjuf

About OpenHands MCP Server

My custom MCP servers for OpenHands

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openhands-mcp": {
      "command": "node",
      "args": [
        "--version",
        "#",
        "Should",
        "be",
        "18.0.0",
        "or",
        "higher"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OpenHands MCP Server?

An MCP (Model Context Protocol) server that extends the capabilities of OpenHands. It provides three standalone tools—for running shell commands, fetching APIs, and simulating audio analysis—plus optional credential management and a Facebook Messenger bot.

How to use OpenHands MCP Server?

Clone the repository, make scripts executable (chmod +x run_lint.sh), verify Node.js 18+ and Python 3 are installed, then configure the three tools as stdio_servers in OpenHands (Settings → MCP) using the provided JSON snippet. Test each script individually with the given command-line examples.

Key features of OpenHands MCP Server

analyze_audio.py – simulates audio transcription and summarization
call_api.js – fetches JSON from any URL with comprehensive error handling
run_lint.sh – simulates a lint check on a codebase
No external dependencies beyond Python, Node.js, and Bash
Optional password manager and .env to store API credentials
Facebook bot for automated customer service (VIV Clinic)

Use cases of OpenHands MCP Server

Fetch live data (e.g., Bitcoin price) and let OpenHands summarize it
Run a simulated linter to check code quality inside OpenHands
Transcribe a podcast episode using the audio analysis tool
Deploy an automated Facebook Messenger bot that saves inquiries to Google Sheets

FAQ from OpenHands MCP Server

What does the OpenHands MCP Server do?

It adds three MCP tools to OpenHands: one runs shell commands, one calls external APIs, and one simulates audio processing. All communicate via stdio.

What runtime dependencies are required?

Python 3.x for analyze_audio.py, Node.js 18+ for call_api.js, and Bash for run_lint.sh. No extra packages are needed—all scripts use built‑in libraries.

How do I configure the server inside OpenHands?

In OpenHands go to Settings → MCP and add each script as a stdio_servers entry with its command and arguments (see the README’s JSON example).

Can I authenticate API requests?

Yes. You can store credentials in a .env file and use the included password_manager.py to retrieve them. The call_api_with_auth.js script supports bearer and Facebook authentication.

Are there any known limitations?

The audio and lint tools are simulations—they do not perform real transcription or linting. The server uses stdio transport only (no SSE). The VIV Clinic bot is separate from the three MCP tools.

Frequently asked questions

What does the OpenHands MCP Server do?

It adds three MCP tools to OpenHands: one runs shell commands, one calls external APIs, and one simulates audio processing. All communicate via stdio.

What runtime dependencies are required?

Python 3.x for `analyze_audio.py`, Node.js 18+ for `call_api.js`, and Bash for `run_lint.sh`. No extra packages are needed—all scripts use built‑in libraries.

How do I configure the server inside OpenHands?

In OpenHands go to Settings → MCP and add each script as a `stdio_servers` entry with its command and arguments (see the README’s JSON example).

Can I authenticate API requests?

Yes. You can store credentials in a `.env` file and use the included `password_manager.py` to retrieve them. The `call_api_with_auth.js` script supports bearer and Facebook authentication.

Are there any known limitations?

The audio and lint tools are simulations—they do not perform real transcription or linting. The server uses stdio transport only (no SSE). The VIV Clinic bot is separate from the three MCP tools.

Comments

Basic information

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.