Filesystem Exec MCP Servers

MCP开发工具

提供方 a-joia

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

MCP Tools 提供工作区内的文件编辑、备份、代码分析和执行功能,专为AI驱动的代码助手和自动化设计。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

文件管理Python本地部署代码分析自动化工具工作区管理代码执行

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run --rm -it -v $(pwd):/app code_exec_mcp-mcp-server

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

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

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Filesystem Exec MCP Servers当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

MCP工具:文件系统、分析和执行

概述

该项目为文件编辑、备份、代码分析和执行提供了强大的、包含工作区的工具,专为人工智能驱动的代码助手和自动化而设计。所有工具都返回结构化字典,便于编程使用。


环境和容器设置

需求

  • Python 3.11+
  • Docker(用于容器化使用)
  • 推荐: black, flake8, vulture, mutmut 用于代码格式化和分析

在Docker中运行

  1. 塑造形象:```sh
    docker build -t mcp-tools .

1. **运行容器:**```sh
docker run --rm -it -v $(pwd):/app code_exec_mcp-mcp-server
  • 要映射自定义工作区,请使用 -v /your/workspace:/app/.workspace.
  1. 在容器内运行测试:sh pytest -v test/scripts

文件系统工具(tools/filesystem.py)

工作空间管理

  • set_workspace(workspace_name:str)->字典

  • 设置活动工作区目录(创建于 .workspace/).

  • 如果工作区不存在,则创建它。为了安全起见,所有文件操作都包含在此工作区中。
  • 退货: { "status": "success", "old_workspace": ..., "new_workspace": ..., "message": ... }

  • get_workspace()->字典

  • 获取当前工作区路径和状态。

  • 退货: { "status": "success", "workspace": ..., "exists": ..., "is_dir": ... }

文件编辑与差异

  • edit_file(文件路径,内容=无,create_backup=真,模式=无,diff_text=无,line_number=无,new_content=无,start_line=无,end_line=没有)->dict

  • 原子编辑文件。支持多种模式:

  • 覆盖:将文件替换为 content (默认模式)。
  • 标准差异:应用统一的差异(mode="unified_diff", diff_text).
  • 编辑线:替换一条线(mode="line_edit", line_number, new_content).
  • 跨度编辑:替换一系列线路(mode="span_edit", start_line, end_line, new_content).
  • 如果 create_backup 如果为True,则在编辑之前会进行备份。
  • 所有更改都是原子性的(写入临时文件,然后移动)。
  • 退货: { "status": "success"|"error", "filepath": ..., "mode": ..., "changes_made": ..., "preview": ..., ... }
  • 边缘案例:
  • 如果文件在工作区之外,或者所选模式缺少必需的参数,则返回错误。
  • 稳健地处理编码问题和大文件。

  • preview_edit(…)/validate_endit(…)

  • 预览或验证编辑而不应用它。

  • 退货: 带有状态、预览和/或验证错误的骰子。
  • 用途: 使用前 edit_file 检查会发生什么变化或验证参数。

备份和恢复

  • 备份文件(文件路径)->字典

  • 在中创建文件的带时间戳的备份 .mcp_backups/ 在工作空间内。

  • 存储文件和JSON元数据文件。
  • 退货: { "status": "success"|"error", "backup_file": ..., "timestamp": ..., ... }
  • 边缘案例:
  • 如果文件不存在或位于工作区之外,则返回错误。

  • restore_file(文件路径,backup_timestamp=无)->dict

  • 从备份中还原文件(按时间戳)。如果没有给出时间戳,则还原最新备份。

  • 退货: { "status": "success"|"error", "restored_from": ..., ... }
  • 边缘案例:
  • 如果不存在备份或时间戳无效,则返回错误。

  • list_backups(文件路径=无)->dict

  • 列出文件的所有备份或工作区中的所有文件。

  • 退货: { "status": "success", "backups": [...], "total_backups": ... }
  • 每个备份条目都包括文件路径、时间戳、提交状态和元数据。

  • commit-changes(文件路径,commit_message=“”)->dict

  • 通过消息将最新备份标记为已提交。

  • 退货: { "status": "success"|"error", ... }
  • 边缘案例:
  • 如果文件不存在备份,则返回错误。

差异和格式

  • compare_versions(文件路径,backup_timestamp=None)->dict

  • 显示当前文件和备份之间的统一差异(按时间戳)。

  • 退货: { "status": "success"|"error", "diff": ..., ... }
  • 边缘案例:
  • 如果文件或备份不存在,则返回错误。

  • generate_diff(text1,text2,filename=“file.txt”)->dict

  • 在两个文本blob之间生成统一的差异。

  • 退货: { "status": "success"|"error", "diff": ... }

  • format_code(文件路径)->dict

  • 使用格式化Python文件 black (必须安装在环境中)。

  • 退货: { "status": "success"|"error", "message": ... }
  • 边缘案例:
  • 如果出现以下情况,则返回错误 black 未安装或文件不是有效的Python。

文件系统列表和文件切片

  • list_path(path=“.”)->dict

  • 列出给定路径下的文件和目录(非递归)。

  • 退货: { "status": "success"|"error", "entries": [ {name, is_dir, size, mtime}, ... ] }
  • 边缘案例:
  • 如果路径不存在或不是目录,则返回错误。

  • list_path_re草书(path=“.”)->字典

  • 递归列出路径下的所有文件和目录。

  • 退货: { "status": "success"|"error", "entries": [ {path, is_dir, size, mtime}, ... ] }

  • get_head(文件路径,n=10)->字典

  • 获取第一个 n 文件的行数(默认值为10)。

  • 退货: { "status": "success"|"error", "lines": [...] }
  • 边缘案例:
  • 如果文件小于,则返回所有行 n 线。
  • 如果文件不存在,则返回错误。

  • get_tail(文件路径,n=10)->dict

  • 获取最后一个 n 文件的行数(默认值为10)。

  • 退货: { "status": "success"|"error", "lines": [...] }
  • 边缘案例:
  • 如果文件小于,则返回所有行 n 线。
  • 如果文件不存在,则返回错误。

  • get_lines(文件路径、开始、结束)->dict

  • 从以下位置获取行 start 到 end (含1)。

  • 退货: { "status": "success"|"error", "lines": [...] }
  • 边缘案例:
  • 如果范围无效或文件不存在,则返回错误。

分析工具(tools/analysis.py)

  • check_syntax(文件路径)->列表[str]

  • 检查Python语法。如果有效,则返回空列表,否则返回错误消息列表(每个错误一个)。

  • 边缘案例:
  • 处理语法错误、文件丢失和编码问题。

  • check_syntax_multiple_files(文件路径)->Dict[str,List[str]]

  • 检查多个文件的语法。返回一个将文件路径映射到错误列表的字典。

  • lint_file(文件路径)->str

  • 跑 flake8 文件上的门楣。以字符串形式返回linter输出。

  • 边缘案例:
  • 如果出现以下情况,则返回错误消息 flake8 未安装或文件丢失。

  • run_mutation_tests(文件路径,test_file=无)->str

  • 使用以下命令运行突变测试 mutmut。可选择指定测试文件。

  • 退货: 突变测试运行的输出。

  • search_code(模式,目录=“.”,文件模式=“*.py”)->列表[Dict]

  • 在目录下的代码文件中搜索正则表达式模式。

  • 退货: 包含文件、行号和代码行的字典列表。

  • search_symbols(name,kind=“function”,directory=“.”)->列表[str]

  • 按名称查找函数或类定义。

  • 退货: 文件列表:找到符号的行字符串。

  • find_unused_code(directory=“.”)->列表[str]

  • 使用查找未使用的代码 vulture.

  • 退货: 未使用的代码行或错误消息列表。

  • extract_docstring(文件路径)->Dict[str,str]

  • 从文件中的所有函数和类中提取文档字符串。

  • 退货: 将函数/类名映射到文档字符串。

  • suggest_test_cases(文件路径,函数=无)->str

  • 为函数或文件生成测试骨架。

  • 退货: 带有测试函数或文件模板的字符串。

执行和调试工具(tools/exec_debug.py)

  • execute_python(代码,超时=30)->Dict

  • 在子进程中执行Python代码(作为字符串),并有超时。

  • 退货: 带有状态、stdout、stderr、返回代码和执行时间的Dict。
  • 边缘案例:
  • 如果执行失败或超时,则返回错误状态和消息。

  • execute_python_file(文件,超时=30)->Dict

  • 在子进程中执行Python文件,但有超时。

  • 退货: 带有状态、stdout、stderr、返回代码和执行时间的Dict。

  • debug_python_file(文件,断点,超时=60)->str

  • 在下运行Python文件 pdb 在指定的行号处有断点。

  • 退货: 完整的会话记录为字符串。
  • 边缘案例:
  • 如果文件不存在,则引发FileNotFoundError。
  • 捕获异常并将其打印在成绩单中。

用法

  • 所有函数都设计为从Python导入和调用,或用作AI代理工具集的一部分。
  • 为了安全起见,所有文件操作都包含在工作区中。
  • 所有结果都以字典(或某些分析函数的列表)的形式返回 "status": "success" 或 "error" 以及详细的字段。

常见问题

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

在客户端按下面的安装命令接入:docker run --rm -it -v $(pwd):/app code_exec_mcp-mcp-server。装完在客户端配置里引用同一个包或端点。

Filesystem Exec MCP Servers 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Filesystem Exec MCP Servers 收费吗?

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

Filesystem Exec MCP Servers 需要 API Key 吗?

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

Filesystem Exec MCP Servers 能提供哪些能力?

资料显示能力标签包括 代码分析、代码执行、Python、工作区管理、文件管理。具体工具清单以官方文档为准。

Filesystem Exec MCP Servers 需要什么运行环境?

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

Filesystem Exec MCP Servers 是本地还是远程?

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

热门专题

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

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