项目简介

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获取最新的库文档和代码示例

信息

分类

开发者工具