用shell脚本编写的极简MCP服务器。

本仓库是对文章《极简MCP服务器》bash脚本的补充

MCP服务器的生命周期可分为两个阶段。初始化与运行。

mcp_add.sh实现了该生命中的所有消息，从握手到简单的“加两个数字”工具执行。

要正确执行基本测试方法，请使用：

LLM 主机配置

mcphost 和 Claude Desktop 的 JSON 配置文件：

与麦克波斯特的测试

在bash脚本中添加执行：

运行 mcphost，使用 llama3.1 和工具配置文件

参考文献

• 模型上下文协议 https://www.anthropic.com/news/model-context-protocol
• mcphost https://github.com/mark3labs/mcphost
• jsonrpc 规范：https://www.jsonrpc.org/specification
• MCP检查员 https://github.com/wong2/mcp-cli

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