这是一个从 'coding-the-coding-agents' GitHub仓库中提取的简易MCP服务器实现示例。

项目简介

该服务器是一个简单的 MCP 后端，其核心功能是将 Bash 命令行执行的能力封装成一个 MCP 工具。通过运行此服务器，任何支持 MCP 协议的客户端（如基于大型语言模型的应用）都可以远程调用 Bash 命令，从而实现与服务器所在系统的基本交互。它展示了如何使用 'mcp.server' 库快速构建一个功能单一但实用的 MCP 工具服务。

主要功能点

• Bash 命令执行： 提供一个名为 'bash' 的工具，接受一个字符串参数作为要执行的命令行。
• 结果返回： 执行命令后，将标准输出作为工具调用的结果返回给客户端。
• Stdio 传输： 服务器通过标准输入/输出来与客户端通信，使用 MCP 定义的 JSON-RPC 协议。

安装步骤

1. 克隆包含此服务器代码的仓库：

   git clone https://github.com/zencoderai/coding-the-coding-agents.git
   

2. 进入仓库目录：

   cd coding-the-coding-agents
   

3. 安装运行所需的 Python 'mcp' 库：

   pip install mcp
   

服务器配置

此MCP服务器通常不是独立运行的，而是由一个MCP客户端启动并与之通信（例如仓库中的 'agent_w_mcp/agent_w_mcp.py' 脚本）。客户端需要通过配置文件（通常为JSON格式）来指定如何启动这个服务器。对于这个Bash工具服务器，客户端配置文件中需要包含一个服务器条目（例如命名为 "bash"），并提供以下关键启动信息：

• 'command': 用于执行服务器脚本的可执行文件（例如，'"python"'）。
• 'args': 一个字符串列表，作为传递给 'command' 的参数。其中应包含指向 'agent_w_mcp/bash_tool_fastmcp.py' 脚本文件的路径。

客户端会根据这些配置信息启动服务器进程，并通过标准输入输出流建立MCP通信连接。

基本使用方法

1. 运行服务器： 通常由配置好的 MCP 客户端自动启动。如果需要单独测试，可以直接运行：

   python agent_w_mcp/bash_tool_fastmcp.py
   

   此时服务器会等待来自标准输入的 MCP JSON-RPC 请求。
2. 通过客户端交互： 运行配置好此Bash服务器的MCP客户端应用程序。客户端会连接到服务器（如果客户端启动了服务器），发现 'bash' 工具，并允许LLM或其他逻辑调用该工具来执行命令行操作。