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仓库