mcpField
A
Alist MCP Server

Alist MCP Server

Local
github.com/JavanShenFiles & Storage5Updated 77w ago
Repository

About Alist MCP Server

Alist MCP Server connects Alist to MCP through the Alist API. It requires an Alist address and token for configuration.

Key features

  1. 01Alist API-based MCP server
  2. 02Alist host configuration
  3. 03Token-based authorization

Use cases

  1. 01Connecting an Alist instance to an MCP client
  2. 02Configuring access with an Alist token

MCP support

It provides an MCP server implemented through the Alist API. The configuration uses an Alist host and token.

#alist#mcp-server#api

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "alist": {
      "command": "npx",
      "args": [
        "-y",
        "alist-mcp-server"
      ],
      "env": {
        "ALIST_HOST": "<ALIST_HOST>",
        "ALIST_TOKEN": "<ALIST_TOKEN>"
      }
    }
  }
}
Run commandnpx -y alist-mcp-server
Environment variables to set
ALIST_HOST
ALIST_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmalist-mcp-server

Tools

15

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
pathstringNo
passwordstringNo
pageintegerNo
per_pageintegerNo
refreshbooleanNo

Details

From the project README

Alist MCP Server

通过 Alist API 实现的 MCP server

使用

你需要提供Alist地址和Token

如何获取Token

按F12打开“调试”，选中“网络”，随意在左侧选择请求，找到携带 Authorization 参数的就可以

README image
Using npm
{
  "mcpServers": {
    "alistApi": {
      "command": "npx",
      "args": ["-y", "alist-mcp-server"],
      "env": {
        "ALIST_HOST": "https://example.com",
        "ALIST_TOKEN": "your_token_here"
      }
    }
  }
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.