MCP Server Bash

🚀 mcp-server-bash

シェルスクリプトで作成された最小限のMCPサーバーです。

このリポジトリは、以下の記事の補足となっています：シェルスクリプトで実装された最小限のMCPサーバー

MCPサーバーのライフサイクルは、初期化と実行の2つの段階に分けることができます。

mcp_add.shは、ハンドシェイクプロトコルから単純な「加法」ツールの実行まで、ライフサイクル全体のすべてのメッセージを実装しています。

🚀 クイックスタート

基本的なCLIテスト方法

# テストtools/listメソッド
echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":2}' | bash mcp_add.sh | jq 

# テストmath_additionツール
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

...

mathツールを使用して10と88を足す

📚 ドキュメント

参考資料

• Model Context Protocol MCPプロトコル
• mcphost GitHubリポジトリ
• JSON-RPC仕様：Specification
• mcp inspector GitHubリポジトリ