# 安装 Audiobookshelf

- 类型: MCP 工具
- 说明: Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync
- 仓库: https://github.com/ni-c/audiobookshelf-mcp

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Audiobookshelf" MCP 服务：
执行：claude mcp add 'io-github-ni-c-audiobookshelf-mcp' -- npx -y audiobookshelf-mcp
```

### Codex
```
请帮我安装 askskill 上的 "Audiobookshelf" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-ni-c-audiobookshelf-mcp]
command = "npx"
args = ["-y","audiobookshelf-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Audiobookshelf" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-ni-c-audiobookshelf-mcp": { "command": "npx", "args": ["-y","audiobookshelf-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env AUDIOBOOKSHELF_URL=YOUR_VALUE --env AUDIOBOOKSHELF_API_KEY=YOUR_VALUE --env AUDIOBOOKSHELF_READ_ONLY=YOUR_VALUE --env AUDIOBOOKSHELF_INSECURE_TLS=YOUR_VALUE --env AUDIOBOOKSHELF_ALLOW_TOOLS=YOUR_VALUE --env AUDIOBOOKSHELF_DENY_TOOLS=YOUR_VALUE --transport stdio io-github-ni-c-audiobookshelf-mcp -- npx -y audiobookshelf-mcp
```
需要环境变量：AUDIOBOOKSHELF_URL, AUDIOBOOKSHELF_API_KEY, AUDIOBOOKSHELF_READ_ONLY, AUDIOBOOKSHELF_INSECURE_TLS, AUDIOBOOKSHELF_ALLOW_TOOLS, AUDIOBOOKSHELF_DENY_TOOLS

### Codex
```bash
codex mcp add --env AUDIOBOOKSHELF_URL=YOUR_VALUE --env AUDIOBOOKSHELF_API_KEY=YOUR_VALUE --env AUDIOBOOKSHELF_READ_ONLY=YOUR_VALUE --env AUDIOBOOKSHELF_INSECURE_TLS=YOUR_VALUE --env AUDIOBOOKSHELF_ALLOW_TOOLS=YOUR_VALUE --env AUDIOBOOKSHELF_DENY_TOOLS=YOUR_VALUE io-github-ni-c-audiobookshelf-mcp -- npx -y audiobookshelf-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-ni-c-audiobookshelf-mcp]
command = "npx"
args = ["-y","audiobookshelf-mcp"]

[mcp_servers.io-github-ni-c-audiobookshelf-mcp.env]
AUDIOBOOKSHELF_URL = "YOUR_VALUE"
AUDIOBOOKSHELF_API_KEY = "YOUR_VALUE"
AUDIOBOOKSHELF_READ_ONLY = "YOUR_VALUE"
AUDIOBOOKSHELF_INSECURE_TLS = "YOUR_VALUE"
AUDIOBOOKSHELF_ALLOW_TOOLS = "YOUR_VALUE"
AUDIOBOOKSHELF_DENY_TOOLS = "YOUR_VALUE"
```
需要环境变量：AUDIOBOOKSHELF_URL, AUDIOBOOKSHELF_API_KEY, AUDIOBOOKSHELF_READ_ONLY, AUDIOBOOKSHELF_INSECURE_TLS, AUDIOBOOKSHELF_ALLOW_TOOLS, AUDIOBOOKSHELF_DENY_TOOLS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-ni-c-audiobookshelf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "audiobookshelf-mcp"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "YOUR_VALUE",
        "AUDIOBOOKSHELF_API_KEY": "YOUR_VALUE",
        "AUDIOBOOKSHELF_READ_ONLY": "YOUR_VALUE",
        "AUDIOBOOKSHELF_INSECURE_TLS": "YOUR_VALUE",
        "AUDIOBOOKSHELF_ALLOW_TOOLS": "YOUR_VALUE",
        "AUDIOBOOKSHELF_DENY_TOOLS": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-ni-c-audiobookshelf-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImF1ZGlvYm9va3NoZWxmLW1jcCJdLCJlbnYiOnsiQVVESU9CT09LU0hFTEZfVVJMIjoiWU9VUl9WQUxVRSIsIkFVRElPQk9PS1NIRUxGX0FQSV9LRVkiOiJZT1VSX1ZBTFVFIiwiQVVESU9CT09LU0hFTEZfUkVBRF9PTkxZIjoiWU9VUl9WQUxVRSIsIkFVRElPQk9PS1NIRUxGX0lOU0VDVVJFX1RMUyI6IllPVVJfVkFMVUUiLCJBVURJT0JPT0tTSEVMRl9BTExPV19UT09MUyI6IllPVVJfVkFMVUUiLCJBVURJT0JPT0tTSEVMRl9ERU5ZX1RPT0xTIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：AUDIOBOOKSHELF_URL, AUDIOBOOKSHELF_API_KEY, AUDIOBOOKSHELF_READ_ONLY, AUDIOBOOKSHELF_INSECURE_TLS, AUDIOBOOKSHELF_ALLOW_TOOLS, AUDIOBOOKSHELF_DENY_TOOLS