mcp-server-bash

mcp-server-bash

シェルスクリプトで書かれたミニマルな MCP サーバーです。

このリポジトリは、記事「Minimalistic MCP Server in bash script」の補足です。

MCP サーバーのライフサイクルは、2 つのフェーズに分けて説明できます。初期化と運用です。

mcp_add.sh は、このライフサイクル内のすべてのメッセージを実装しています。ハンドシェイクから、シンプルな「2 つの数値を加算する」ツールの実行までです。

基本的なテストメソッドをコマンドラインで直接実行するには、次を使用します:

# 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 ホストの設定

mcphost および Claude Desktop 用の JSON 設定ファイル:

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

mcphost でのテスト

bash スクリプトに実行権限を追加します:

chmod +x mcp_add.sh

llama3.1 とツール設定ファイルを使用して mcphost を実行します

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

...

using math tool add 10 and 88

参考資料

• Model Context Protocol https://www.anthropic.com/news/model-context-protocol
• mcphost https://github.com/mark3labs/mcphost
• jsonrpc 仕様: https://www.jsonrpc.org/specification
• mcp inspector https://github.com/wong2/mcp-cli