JinDaGe - Nash MCP Details

article

README

🚀 Nash MCP 服务器

Nash MCP（模型上下文协议 (MCP) 服务器）无缝集成了命令执行、Python 代码运行、网络内容获取和任务管理等功能，为用户提供高效便捷的操作体验。

🚀 快速开始

安装要求

Python 3.11+
Poetry 包管理器（推荐）

安装步骤

git clone https://github.com/nash-run/nash-mcp.git
cd nash-mcp
poetry install

✨ 主要特性

命令执行：运行 shell 命令并处理错误。
Python 执行：运行 Python 代码并捕获错误。
安全凭证：存储和访问 API 密钥，避免敏感数据泄露给大语言模型 (LLM)。
网络内容获取：抓取并解析网页内容进行分析。
任务管理：保存和整理可复用的任务。

📦 安装指南

环境变量配置

以下环境变量需在运行时指定： | 属性 | 详情 | |------|------| | NASH_LOGS_PATH | 指定日志文件的存储路径 | | NASH_TASK_DIR | 定义任务文件的存放位置 |

💻 使用示例

工具模块

命令执行

execute_command(command: str) -> str

参数：command - 要运行的 shell 命令
返回值：命令输出或错误信息

Python 执行

execute_python(code: str, file_name: str = "") -> str

参数：

code: 待执行的 Python 代码片段
file_name (可选): 存放代码文件的名称，默认为空字符串

📚 详细文档

常见注意事项

⚠️ 重要提示

所有 API 密钥需通过环境变量加载，避免硬编码。

所有操作和工具执行的日志均记录在指定目录下，便于后续排查问题。

建议定期审查服务器代码和配置文件，确保无未授权访问风险。

开发指南

日志系统

详细的按时间戳记录的操作日志存储于 NASH_LOGS_PATH 指定的目录中，内容涵盖所有操作及工具执行情况。

测试框架

poetry run pytest

带代码覆盖率测试：

poetry run pytest --cov=nash_mcp

📄 许可证

MIT License

Nash