ABSD MCP

MCPAI代理

提供方 anthonybir · 包名 @anthonybir/devops-mcp@latest

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

本地优先的模型上下文协议(MCP)服务器,为AI助手提供安全的文件系统和终端操作。

一句话选型结论

按资料字段整理

ABSD MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文件系统操作TypeScript本地部署终端管理安全协议AI助手工具本地开发

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx @anthonybir/devops-mcp@latest

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ABSD MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方anthonybir上游标注的维护方 anthonybir
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@anthonybir/devops-mcp@latest · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.4 KB
来自项目仓库与上游目录的原文,未做删改

ABSD DevOps MCP 服务器

本地优先模型上下文协议(MCP)服务器,为人工智能助手提供安全的文件系统和终端操作。

特点/功能

  • 22款强大工具9个文件系统 + 4个流式搜索 + 7个终端 + 2个元操作
  • 文件系统操作读取(文件/URL/图像)、写入、列出、创建、移动/重命名、搜索(使用ripgrep)、精细编辑、多重读取
  • 流式搜索带有分页、会话管理和提前终止功能的后台 ripgrep
  • 终端会话带有ANSI感知提示符检测的交互式REPL(Python、Node.js)
  • 流程管理列出系统进程,使用确认令牌进行终止
  • 图像支持MCP 原生图像内容支持 PNG、JPEG、GIF、WebP、BMP 格式(SVG 以文本形式提供,以保障安全)
  • URL 获取HTTP/HTTPS,支持可配置的超时设置和黑名单保护
  • MCP 原语资源(服务器状态)+ 提示(工作流模板)
  • 安全至上路径遍历保护、命令过滤、输入清理、带警告的无限制模式
  • 类型安全使用TypeScript严格模式和Zod模式验证构建
  • 仅限本地完全通过stdio传输在您的机器上运行

⚠️ v0.3.3 兼容性更新: Node.js 要求降低至 >= 20.0.0 现在,原生模块已针对 Node.js 20 构建,因此 Claude Desktop 可以在不出现模块版本错误的情况下加载服务器。如果您之前安装的是 v0.3.3 之前的版本,请重新全局安装并重启 Claude Desktop。

安装

快速入门(推荐)```bash

1. Install globally

npm install -g @anthonybir/devops-mcp

2. Run setup (interactive)

absd-mcp-setup


\`setup\` 命令将:

- ✅ 将MCP服务器添加到Claude Desktop配置中
- ✅ 在指定位置创建默认配置 `~/ABSD_MCP/config.json`
- ✅ 为您的现有Claude配置创建带时间戳的备份

**⚠️ 安全警告:** 默认配置允许访问您的整个主目录。
审查并限制 `allowedDirectories` 设置完成后立即。

**下一步行动:**

1. 审查配置: `~/ABSD_MCP/config.json` (macOS) 或 `%USERPROFILE%\ABSD_MCP\config.json` (Windows)
1. 限制 `allowedDirectories` 仅针对所需路径
1. 重启Claude桌面版

### 卸载```bash
# Remove from Claude Desktop config
absd-mcp-unregister

# Uninstall package
npm uninstall -g @anthonybir/devops-mcp

手动设置

如果您更喜欢手动配置,请参阅 Claude 桌面版设置 在......下面

使用 npx(无需安装)```bash

npx @anthonybir/devops-mcp@latest


需要手动配置Claude Desktop(见下文)。

### Codex CLI 设置(TOML 格式)

如果你运行 Codex CLI(注:Codex通常指某种规范或标准,CLI代表命令行界面,但具体含义需结合上下文确定,此处为直译)首先全局安装该包,然后在你的(配置/设置中)添加一个MCP条目 `codex.toml`:```toml
[[mcp]]
name = "absd-devops"
command = "absd-mcp"
args = []
working_directory = "/Users/yourusername"
env = { ABSD_MCP_CONFIG = "/Users/yourusername/ABSD_MCP/config.json" }

保存文件后运行 codex mcp reload (或重启Codex)以便选择新的服务器。更新路径以匹配您的环境。

来自源(或“来源”)```bash

git clone https://github.com/anthonybir/ABSD_MCP.git
cd ABSD_MCP
pnpm install
pnpm build


## 配置

创建一个 `config.json` 文件(或从……复制 `config.example.json`):```json
{
"allowedDirectories": [
"/Users/yourusername/Projects",
"/Users/yourusername/Documents"
],
"blockedCommands": [
"rm -rf /",
"dd if=/dev/zero",
"mkfs",
"shutdown",
"reboot"
// ... see config.example.json for full list of 31 default blocked commands
],
"fileReadLineLimit": 2000,
"fileWriteLineLimit": 75,
"sessionTimeout": 1800000,
"logLevel": "info",
"urlDenylist": ["localhost", "127.0.0.1", "0.0.0.0", "::1"],
"urlTimeout": 10000
}

配置选项

  • 允许的目录允许文件操作的绝对路径数组(空数组 = 无限制访问)
  • 被阻止的命令拒绝执行的危险命令数组(默认:[])
  • 文件写入行限制每次操作最多写入的行数(默认:50)
  • 会话超时进程会话超时时间(以毫秒为单位)(默认:1800000 = 30分钟)
  • 日志级别日志级别(debug · info · warn · error(默认: info)
  • urlDenylist(中文可译为“URL拒绝列表”或“URL阻止列表”)用于阻止URL获取的主机名数组(默认: ["localhost", "127.0.0.1", "0.0.0.0", "::1"])

启用完整文件系统访问权限(高级)

设定;套装;一套 allowedDirectories 到一个空数组([])如果您希望ABSD访问您机器上的所有路径。 你必须保持 blockedCommands 人口稠密的—如果两个列表都为空,服务器将拒绝启动。```json
{
"allowedDirectories": [],
"blockedCommands": [
"rm -rf /",
"dd if=/dev/zero",
"mkfs",
"shutdown",
"reboot",
"init 0"
// ...and the rest from config.example.json
]
}


仅在可信任的本地机器上使用无限制模式,并保留扩展的被阻止命令列表(31项),以避免执行意外的破坏性命令。

### 路径格式化

**Windows 用户:** 在JSON中使用正斜杠以避免转义问题:

- ✅ `"C:/Users/yourusername/Projects"`
- ✅ `"C:\\\\Users\\\\yourusername\\\\Projects"` (双转义的反斜杠)

**macOS/Linux 用户:** 标准绝对路径:

- ✅ `"/Users/yourusername/Projects"`
- ✅ `"/home/username/projects"`

## Claude 桌面版安装

**配置文件位置:**

- **macOS(苹果电脑操作系统):** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

### 选项1:使用已安装的软件包(支持离线使用)

如果你已全局安装,请引用 bin 入口:```json
{
"mcpServers": {
"absd-devops": {
"command": "absd-mcp",
"args": [],
"env": {
"ABSD_MCP_CONFIG": "/path/to/your/config.json"
}
}
}
}

选项2:使用npx(仅限在线)

如果使用 npx 或希望获取最新版本:```json
{
"mcpServers": {
"absd-devops": {
"command": "npx",
"args": ["-y", "@anthonybir/devops-mcp@latest"],
"env": {
"ABSD_MCP_CONFIG": "/path/to/your/config.json"
}
}
}
}


**ABSD_MCP_CONFIG 路径:**

- **macOS:** 使用完整路径,例如 `/Users/yourusername/ABSD_MCP/config.json`
- **Windows:** 使用正斜杠,如 `C:/Users/yourusername/ABSD_MCP/config.json`

重启Claude桌面应用以激活服务器。

## 可用工具

### 文件系统工具 (9)

- **读取文件**读取支持图像格式(PNG、JPEG、GIF、WebP、BMP)的文件或URL,可选分块处理,以及偏移量支持(出于安全考虑,SVG被视为文本处理)
- **读取多个文件**同时读取多个文件,每个文件大小限制为1MB,总大小限制为5MB
- **写文件**以追加模式选项创建或覆盖文件
- **列出目录**递归列出目录内容并控制深度
- **创建目录**创建目录并递归创建父目录
- **移动文件**移动或重命名文件和目录(两者路径均已验证以确保安全)
- **获取文件信息**获取详细的元数据(大小、权限、时间戳、行数)
- **搜索文件**使用 ripgrep 搜索模式(正则表达式、字面量、文件过滤)
- **编辑模块**手术文本替换并进行唯一性验证

### 流媒体搜索工具(4)

- **开始搜索**以文件模式或内容模式启动后台 ripgrep 搜索
- `contextLines`匹配项周围的上下文行数(默认:3)
- **提示:** 设定;套装;一套 `contextLines: 0` 用于简洁输出,不包含上下文信息
- **获取更多搜索结果**使用基于偏移量的导航获取分页结果
- **停止搜索**提前终止正在进行的搜索会话
- **搜索列表**查看所有活跃的搜索会话,包括状态和结果数量

### 终端工具(7)

- **启动进程**启动交互式终端会话(Python、Node.js、bash)
- **与进程交互**发送命令时,使用ANSI感知的REPL提示符检测(strip-ansi)
- **读取进程输出**从后台进程中检索缓冲输出
- **列出会话**查看所有带有状态的活跃MCP终端会话
- **终止进程**通过PID停止MCP会话
- **列出进程**列出所有系统进程(跨平台:Windows/macOS/Linux)
- **终止进程**通过确认令牌验证来终止系统进程

### 元工具(2)

- **获取配置**获取当前服务器配置(只读),包括安全状态和元数据
- **获取使用统计信息**获取服务器使用统计信息,包括运行时间、工具调用次数(仅成功调用)以及活跃会话/搜索数量。服务器重启时统计信息会重置。

## MCP 原语(或基本操作)

### 资源

暴露服务器状态和配置:

- **配置://absd-mcp/服务器**当前服务器配置(允许的目录、限制)

### 提示

为常见工作流程预配置的模板:

- **分析代码库**分析项目结构和技术栈
- **设置Python环境**交互式Python开发环境
- **搜索并替换**带引导替换的模式搜索

## 安全

这个MCP服务器实现了多层安全机制:

1. **路径验证**所有文件操作均针对允许的目录进行验证
1. **符号链接解析**防止基于符号链接的路径遍历攻击
1. **命令过滤**阻止危险的终端命令
1. **输入消毒(或输入净化)**移除空字节和控制字符
1. **Zod 验证**所有工具输入均经过严格模式验证

## 发展

### 运行测试```bash
pnpm test                 # Run all tests
pnpm test:security       # Run security tests only

建筑;建筑物```bash

pnpm build # Build for production
pnpm dev # Development mode with watch


### 使用MCP Inspector进行测试```bash
npx @modelcontextprotocol/inspector pnpm dev

故障排除

服务器未出现在Claude中

  1. 检查 claude_desktop_config.json 中 config.json 的路径是否正确
  2. 完全重启Claude桌面版
  3. 检查Claude的MCP日志中的错误

权限错误

确保所有路径在 allowedDirectories 存在并且可通过您的用户帐户访问。

命令被阻止

如果合法命令被阻止,请检查 blockedCommands 在你的配置中的数组。

做出贡献

欢迎投稿!请:

  1. 为仓库创建分支(或“克隆仓库”)
  2. 创建一个特性分支
  3. 为新功能添加测试
  4. 确保所有测试通过(pnpm test)
  5. 提交一个拉取请求

许可证

MIT 许可证 - 详见 许可证 文件中有详细信息。

作者

安东尼·比尔

链接

  • MCP规范
  • MCP TypeScript SDK
  • 问题追踪器

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
ABSD MCP 怎么安装?

在客户端按下面的安装命令接入:npx @anthonybir/devops-mcp@latest。对应的包名是 @anthonybir/devops-mcp@latest。装完在客户端配置里引用同一个包或端点。

ABSD MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

ABSD MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ABSD MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

ABSD MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

ABSD MCP 能提供哪些能力?

资料显示能力标签包括 安全协议、TypeScript、Claude、本地开发。具体工具清单以官方文档为准。

ABSD MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

ABSD MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。