feiniunas-mcp

feiniunas-mcp

MCP server for managing FeiNiu fnOS NAS via AI chat. Supports system status, Docker container operations, and disk information retrieval.

Category
Visit Server

README

@wangguanxiao/feiniunas-mcp

飞牛 fnOS NAS 管理 MCP 服务，通过小智 AI 对话即可管理 NAS。

功能

  • get_nas_status — 获取 NAS 系统状态（主机名、运行时间、CPU 负载、内存、磁盘概况）
  • list_docker_containers — 列出所有 Docker 容器及运行状态
  • get_disk_info — 获取磁盘/存储详细信息
  • control_docker_container — 启动/停止/重启/删除 Docker 容器

安装

npm install -g @wangguanxiao/feiniunas-mcp

使用

在 xiaozhi.config.json 中配置

{
  "mcpServers": {
    "feiniunas": {
      "command": "npx",
      "args": ["-y", "@wangguanxiao/feiniunas-mcp"]
    }
  }
}

或本地开发模式：

{
  "mcpServers": {
    "feiniunas": {
      "command": "node",
      "args": ["/path/to/feiniunas-mcp/run.js"]
    }
  }
}

示例对话

  • "NAS 现在什么状态？" → 调用 get_nas_status
  • "列出所有 Docker 容器" → 调用 list_docker_containers
  • "磁盘还剩多少空间？" → 调用 get_disk_info
  • "帮我重启 xxx 容器" → 调用 control_docker_container

开发

# 安装依赖
npm install

# 构建
npm run build

# 本地运行
node run.js

# 类型检查
npm run type-check

要求

  • Node.js >= 18
  • 运行在飞牛 NAS 或 Linux 环境上（依赖 hostname、uptime、free、df、docker 等系统命令）
  • Docker 命令需要当前用户有执行权限

安全说明

  • control_docker_container 对容器名做了字符校验，只允许字母数字和 _-.:
  • 不支持 exec、run 等可能在容器内执行任意命令的操作
  • 建议以非 root 用户运行，配合 Docker 用户组权限

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured