1. Conduid
  2. Developer Tools
  3. Bash
MCP server · Developer Tools

Bash

by · github.com/antonum/mcp-server-bash

minimalistic MCP server written in bash script

Unclaimed MIT last commit a year ago mcpmodel-context-protocolclaudebashshellcommand-execution
InstallView source
54Fair

Scored 4 days ago · breakdown

About Bash

Bash is an MCP server published by antonum in the Developer Tools category: minimalistic MCP server written in bash script.

The repository has 31 stars and 4 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

Claude Code
claude mcp add bash -- npx -y bash-mcp
npx
npx -y bash-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Bash

Powered by Claude · Grounded in docs

I know everything about Bash. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 5 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • !Dependencies pinnedNo lockfile. Installs can pull different code over time.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

1 check has not been run yet.

README

mcp-server-bash

Minimalistic MCP server written in shell script.

This repo is comlimentary to the article: Minimalistic MCP Server in bash script

The lifecycle of MCP server can be described in two phases. Initialization and Operation.

Phases of MCP

The mcp_add.sh implements all of the messages within this lifecicle, from the handshake to execution of the simple "add two numbers" tool.

To do the basic test methods right in CLI use:

# test tools/list method
echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":2}' | bash mcp_add.sh | jq 

# test math_addition tool
echo '{"jsonrpc":"2.0","id":20, "method":"tools/call","params":{"name":"addition","arguments":{"num1":"1","num2":"2"}}}' | bash mcp_add.sh | jq

LLM host configuration

JSON Configuration file for mcphost and Claude Desktop:

{
    "mcpServers": {
      "math": {
        "command": "/Users/anton/code/mcp-server-bash/mcp_add.sh",
        "args": []
      }
    }
  }

Test with mcphost

Add execute to bash script:

chmod +x mcp_add.sh

Run mcphost with llama3.1 and tool configuration file

mcphost -m ollama:llama3.1:latest --config /Users/anton/code/mcp-server-bash/mcp.json

...

using math tool add 10 and 88

References

README fetched from the repository 5 hours ago. The original is authoritative.

Questions

About Bash

How do I install Bash?

Run claude mcp add bash -- npx -y bash-mcp, then add the server to your MCP client's configuration.

Is Bash safe to use with an AI agent?

Its trust score is 54 out of 100 (fair). It passes 2 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Bash still maintained?

The last commit was a year ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.