项目简介
nu-mcp 是一个基于 Model Context Protocol (MCP) 的服务器实现,使用官方 Rust SDK (rmcp) 将 Nushell 命令执行能力暴露给LLM客户端,同时支持模块化工具扩展。
主要功能
- 核心命令执行:通过 'run_nushell' 工具执行任意Nushell命令
- 扩展工具系统:从模块化目录加载Nushell脚本工具
- 预置工具集:包含Kubernetes、ArgoCD、天气、金融、Tmux等多种实用工具
- 安全沙箱:配置可访问的目录范围,防止路径遍历攻击
- 多种运行模式:支持核心模式、扩展模式和混合模式
安装方法
Nix 安装
# 完整安装 nix profile install github:ck3mp3r/nu-mcp # 单独安装工具 nix profile install github:ck3mp3r/nu-mcp#mcp-tools # 或通过Homebrew brew tap ck3mp3r/nu-mcp https://github.com/ck3mp3r/nu-mcp brew install nu-mcp
服务器配置
MCP客户端需要配置以下信息来连接服务器:
{ "mcpServers": { "nu-mcp": { "command": "nu-mcp", "args": ["--tools-dir=./tools", "--add-path=/tmp"] }
配置参数说明:
- 'command': "nu-mcp" - 服务器可执行命令
- 'args':
- '--tools-dir=PATH' - 指定工具模块目录
- '--enable-run-nushell' - 启用通用命令执行功能
- '--add-path=PATH' - 添加额外的可访问路径(当前目录始终可访问)
基本使用方法
核心模式(默认)
nu-mcp
提供 'run_nushell' 工具用于执行任意Nushell命令
扩展模式
nu-mcp --tools-dir=./tools
加载预置工具模块,每个工具都是包含 'mod.nu' 入口文件的目录
混合模式
nu-mcp --tools-dir=./tools --enable-run-nushell
同时支持核心命令执行和扩展工具
可用工具
- Kubernetes - 完整的kubectl/Helm接口,包含22个工具和三重安全模型
- ArgoCD - 通过HTTP API管理ArgoCD应用和资源
- Weather - 使用Open-Meteo API获取当前天气和预报
- Finance - 使用Yahoo Finance API获取股票价格和金融数据
- Tmux - Tmux会话和窗格管理
- Context7 - 从Context7获取最新的库文档和代码示例
信息
分类
开发者工具