Nash MCP Server

产品定位

Nash MCP Server 是一个多功能的服务，专注于提供高效的命令执行、代码运行和任务管理能力，适用于开发者和自动化任务的需求。

核心功能

• 命令执行：运行 shell 命令并提供错误处理和输出捕获。
• Python 执行：执行 Python 代码片段，支持错误处理。
• 安全凭证管理：安全存储和访问 API 密钥，避免敏感数据暴露。
• 网页内容访问：获取并解析网页内容以供分析。
• 任务管理：保存、组织和运行可重用的工作流和脚本。

适用场景

• 自动化脚本执行
• 开发环境中的代码调试和运行
• 网页内容抓取和分析
• 任务和工作流管理

工具列表

Execute Module

• execute_command：运行 shell 命令并捕获输出。
• list_session_files：列出当前会话中的所有 Python 文件。
• get_file_content：获取文件内容以供查看和编辑。
• edit_python_file：使用精确字符串匹配编辑现有 Python 文件。
• execute_python：执行 Python 代码片段。
• list_installed_packages：列出已安装的 Python 包。

Web Interaction

• fetch_webpage：获取并转换网页内容为可读文本。

Secrets Management

• nash_secrets：安全访问存储的 API 密钥和凭证。

Task Management

• save_nash_task：创建可重用的任务。
• list_nash_tasks：列出所有保存的任务。
• run_nash_task：运行保存的任务。
• execute_task_script：运行任务中的特定脚本。
• view_task_details：查看任务的详细信息。
• delete_nash_task：删除不再需要的任务。

常见问题解答

• 如何避免常见错误？：遵循预编码清单，检查可用包、密钥和现有文件。
• 如何高效编辑文件？：优先使用 edit_python_file 进行小修改，创建新文件时考虑令牌效率。
• 如何管理凭证？：使用 nash_secrets 安全访问凭证。

使用教程

使用依赖

• Python 3.11+
• Poetry 包管理器

安装教程

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

调试方式

poetry run pytest

带覆盖率的测试

poetry run pytest --cov=nash_mcp

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。