Bash SDK

MCP开发工具

提供方 muthuishere

开发工具 未标注 无需鉴权 社区 / 第三方 VS Code

一个轻量级的、零开销的Bash实现的Model Context Protocol (MCP)服务器,支持JSON-RPC 2.0协议和动态工具发现。

一句话选型结论

按资料字段整理

Bash SDK 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 VS Code,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 507 仓库热度,无公开仓库时显示未标注
工具数 1 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量1暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Shell本地部署轻量级服务器JSON-RPCBash脚本工具发现AI系统集成

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 1 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 VS Code,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 VS Code 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Bash SDK当前 1 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方muthuishere上游标注的维护方 muthuishere
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.4 KB
来自项目仓库与上游目录的原文,未做删改

🐚 Bash中的MCP服务器

一个轻量级的、零开销的实现 模型上下文协议(MCP) 纯Bash中的服务器。

为什么? 大多数MCP服务器只是带有模式转换的API包装器。此实现为Node.js、Python或其他繁重的运行时提供了一种零开销的替代方案。


📋 特性

  • ✅ stdio上的完整JSON-RPC 2.0协议
  • ✅ 完成MCP协议的实施
  • ✅ 通过函数命名约定进行动态工具发现
  • ✅ 通过JSON文件进行外部配置
  • ✅ 易于使用自定义工具进行扩展

🔧 需求

  • Bash shell
  • jq 用于JSON处理(brew install jq 在macOS上)

🚀 快速开始

  1. 克隆仓库```bash
    git clone https://github.com/muthuishere/mcp-server-bash-sdk
    cd mcp-server-bash-sdk

2. **使脚本可执行**```bash
chmod +x mcpserver_core.sh moviemcpserver.sh
  1. 试试看```bash
    echo '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "get_movies"}, "id": 1}' | ./moviemcpserver.sh

______________________________________________________________________

## 🏗️ 建筑```
┌─────────────┐         ┌────────────────────────┐
│ MCP Host    │         │ MCP Server             │
│ (AI System) │◄──────► │ (moviemcpserver.sh)    │
└─────────────┘ stdio   └────────────────────────┘
│
┌───────┴──────────┐
▼                  ▼
┌───────────────────┐  ┌───────────────┐
│ Protocol Layer    │  │ Business Logic│
│(mcpserver_core.sh)│  │(tool_* funcs) │
└───────────────────┘  └───────────────┘
│                  │
▼                  ▼
┌─────────────────┐  ┌───────────────┐
│ Configuration   │  │ External      │
│ (JSON Files)    │  │ Services/APIs │
└─────────────────┘  └───────────────┘
  • mcpserver_core.sh:处理JSON-RPC和MCP协议
  • moviemcpserver.sh:包含业务逻辑功能
  • 资产/:JSON配置文件

🔌 创建自己的MCP服务器

工具功能指南

在为MCP服务器实现工具功能时,请遵循以下准则:

  1. 命名规范:所有工具函数必须以前缀 tool_ 后面是tools_list.json中定义的相同名称
  2. 参数:每个函数应接受一个参数 $1 包含JSON参数
  3. 成功模式:对于成功的操作,回显结果并返回0
  4. 错误模式:对于验证错误,回显错误消息并返回1
  5. 自动发现:所有工具函数都会根据tools_list.json自动暴露给MCP服务器

实施步骤

  1. 创建您的业务逻辑文件(例如。, weatherserver.sh)```bash

!/bin/bash

Weather API implementation

Override configuration paths BEFORE sourcing the core

MCP_CONFIG_FILE="$(dirname "${BASH_SOURCE[0]}")/assets/weatherserver_config.json"
MCP_TOOLS_LIST_FILE="$(dirname "${BASH_SOURCE[0]}")/assets/weatherserver_tools.json"
MCP_LOG_FILE="$(dirname "${BASH_SOURCE[0]}")/logs/weatherserver.log"

MCP Server Tool Function Guidelines:

1. Name all tool functions with prefix "tool_" followed by the same name defined in tools_list.json

2. Function should accept a single parameter "$1" containing JSON arguments

3. For successful operations: Echo the expected result and return 0

4. For errors: Echo an error message and return 1

5. All tool functions are automatically exposed to the MCP server based on tools_list.json

Source the core MCP server implementation

source "$(dirname "${BASH_SOURCE[0]}")/mcpserver_core.sh"

Access environment variables

API_KEY="${MCP_API_KEY:-default_key}"

Tool: Get current weather for a location

Parameters: Takes a JSON object with location

Success: Echo JSON result and return 0

Error: Echo error message and return 1

tool_get_weather() {
local args="$1"
local location=$(echo "$args" | jq -r '.location')

Parameter validation

if [[ -z "$location" ]]; then
echo "Missing required parameter: location"
return 1
fi

Call external API

local weather=$(curl -s "https://api.example.com/weather?location=$location&apikey=$API_KEY")
echo "$weather"
return 0
}

Start the MCP server

run_mcp_server "$@"


2. **创建 `assets/weatherserver_tools.json`**```json
{
"tools": [
{
"name": "get_weather",
"description": "Get current weather for a location",
"inputSchema": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "City name or coordinates"
}
},
"required": ["location"]
}
}
]
}
  1. 创建 assets/weatherserver_config.json```json
    {
    "protocolVersion": "2025-03-26",
    "serverInfo": {
    "name": "WeatherServer",
    "version": "1.0.0"
    },
    "capabilities": {
    "tools": {
    "listChanged": true
    }
    },
    "instructions": "This server provides weather information."
    }

4. **使文件可执行**```bash
chmod +x weatherserver.sh

🖥️ 与VS Code和GitHub Copilot一起使用

  1. 更新VS代码设置.json```jsonc
    "mcp": {
    "servers": {
    "my-weather-server": {
    "type": "stdio",
    "command": "/path/to/your/weatherserver.sh",
    "args": [],
    "env": {
    "MCP_API_KEY": "your-api-key"
    }
    }
    }
    }

2. **与GitHub Copilot聊天一起使用**```
/mcp my-weather-server get weather for New York

🚫 局限性

  • 无并发/并行处理
  • 有限的内存管理
  • 无流媒体响应
  • 不是为高吞吐量而设计的

对于人工智能助手和本地工具执行来说,这些都不是阻塞问题。


📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

博客:https://medium.com/@muthuiser/why-i内置-an-mcp服务器-dk-in-shell-y-bash-6f2192072279

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Bash SDK 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Bash SDK 怎么在 VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Bash SDK 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Bash SDK 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Bash SDK 支持哪些客户端?

资料标注支持 VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Bash SDK 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 工具发现、Shell、VS Code。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。