MCP Server Bash

🚀 mcp-server-bash

一個使用Shell腳本編寫的最小化MCP服務器。本項目為文章 用Shell腳本實現的最小化MCP服務器 提供補充內容。該服務器能有效解決特定場景下對輕量級MCP服務器的需求，為相關開發和測試工作提供便利。

🚀 快速開始

MCP服務器的生命週期可分為初始化和運行兩個階段，具體階段劃分如圖所示：

mcp_add.sh 腳本實現了整個生命週期中的所有消息處理，從握手協議到執行簡單的“加法”工具。

基本測試方法

在CLI中可通過以下命令進行基本測試：

測試 tools/list 方法

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

測試 math_addition 工具

# 測試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 進行測試

1. 為bash腳本添加可執行權限：

chmod +x mcp_add.sh

2. 使用 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倉庫