Mcp Server Bash
What is Mcp Server Bash
mcp-server-bash is a minimalistic MCP server implemented in bash script, designed to facilitate the execution of basic operations through a simple command-line interface.
Use cases
Use cases include testing mathematical operations, integrating with LLMs for basic computations, and serving as a lightweight backend for applications requiring simple data processing.
How to use
To use mcp-server-bash, clone the repository, make the script executable using ‘chmod +x mcp_add.sh’, and run it with mcphost along with a configuration file. You can test the server using predefined JSON-RPC commands in the CLI.
Key features
Key features include a minimalistic design, support for JSON-RPC protocol, and the ability to perform basic arithmetic operations like addition through a simple tool.
Where to use
mcp-server-bash can be used in educational environments for teaching programming concepts, in development for quick testing of MCP functionalities, or in any scenario where a lightweight server is needed for basic operations.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Server Bash
mcp-server-bash is a minimalistic MCP server implemented in bash script, designed to facilitate the execution of basic operations through a simple command-line interface.
Use cases
Use cases include testing mathematical operations, integrating with LLMs for basic computations, and serving as a lightweight backend for applications requiring simple data processing.
How to use
To use mcp-server-bash, clone the repository, make the script executable using ‘chmod +x mcp_add.sh’, and run it with mcphost along with a configuration file. You can test the server using predefined JSON-RPC commands in the CLI.
Key features
Key features include a minimalistic design, support for JSON-RPC protocol, and the ability to perform basic arithmetic operations like addition through a simple tool.
Where to use
mcp-server-bash can be used in educational environments for teaching programming concepts, in development for quick testing of MCP functionalities, or in any scenario where a lightweight server is needed for basic operations.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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.
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
- Model Context Protocol https://www.anthropic.com/news/model-context-protocol
- mcphost https://github.com/mark3labs/mcphost
- jsonrpc specification: https://www.jsonrpc.org/specification
- mcp inspector https://github.com/wong2/mcp-cli
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
