Mladensu Cli MCP Server

🚀 CLI MCP 服務器

一個安全的模型上下文協議（MCP）服務器實現，可在具備全面安全功能的環境中執行受控命令行操作，為命令行操作提供安全可靠的執行環境。

🚀 快速開始

本項目是一個安全的MCP服務器，可在受控環境中執行命令行操作，同時提供全面的安全保護和詳細的錯誤處理。

✨ 主要特性

• 命令白名單 enforcement（命令白名單強制實施）
• 選項驗證
• 路徑遍歷防止
• Shell操作符阻止
• 命令長度限制
• 執行超時
• 工作目錄限制

📦 安裝指南

文檔未提及具體安裝步驟，可參考後續開發部分的構建和發佈流程進行操作。

📚 詳細文檔

配置

以下是服務器的環境變量配置：

可用工具

run_command

• 輸入模式:

  {
    "command": string,
    "arguments": array<string>,
    "stdin": string,
    "stdout": boolean,
    "stderr": boolean
  }
  

• 輸出模式:

  {
    "exit_code": number,
    "stdout": string | null,
    "stderr": string | null,
    "error": string | null
  }
  

show_security_rules

• 輸入模式: 無。
• 輸出模式: 列出所有當前的安全規則和配置。

與Claude Desktop的使用

開發/未發佈的服務器配置

uv sync
uv build --dev

已發佈服務器的配置

uv sync
uv build
uv publish --token {{YOUR_PYPI_API_TOKEN}}

安全特性

• 命令白名單 enforcement（命令白名單強制實施）
• 選項驗證
• 路徑遍歷防止
• Shell操作符阻止
• 命令長度限制
• 執行超時
• 工作目錄限制

錯誤處理

服務器提供詳細的錯誤消息，包括：

• 安全違規
• 命令超時
• 無效命令格式
• 路徑安全違規
• 執行失敗

開發

先決條件

• Python 3.10+
• MCP 協議庫

構建和發佈

1. 同步依賴項並更新鎖定文件：

   uv sync
   

2. 構建發行版：

   uv build
   

   這將在 dist/ 目錄中創建源代碼和輪文件。

3. 發佈到 PyPI：

   uv publish --token {{YOUR_PYPI_API_TOKEN}}
   

調試

由於MCP服務器通過標準輸入/輸出運行，調試具有挑戰性。我們強烈推薦使用MCP Inspector進行調試。

你可以使用以下命令啟動Inspector：

npx @modelcontextprotocol/inspector uv --directory {{your source code local directory}}/cli-mcp-server run cli-mcp-server

啟動後，Inspector會顯示一個URL，可以在瀏覽器中訪問以開始調試。

📄 許可證

此項目在MIT License下許可 - 有關詳細信息，請參閱LICENSE文件。

如有更多問題或需要支持，請在項目倉庫打開一個問題。