# agent-tool — Encoding-Safe MCP Tools for Agents

> agent-tool is an MCP tool server with encoding-aware, indentation-safe file tools and an `install` command for Claude Code, Codex, Cursor, and more.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
# install from GitHub Releases (see repo) then:
agent-tool install --safe-approve
# Codex config example:
# [mcp_servers.agent-tool] command = "/path/to/agent-tool"
agent-tool --fallback-encoding EUC-KR
```

## Intro

agent-tool is an MCP tool server with encoding-aware, indentation-safe file tools and an `install` command for Claude Code, Codex, Cursor, and more.

**Best for:** repos with mixed encodings or strict indentation rules (tabs/.editorconfig)

**Works with:** any MCP-capable agent; auto-install supports Claude Code/Codex/Cursor/Cline (per README)

**Setup time:** 5-12 minutes

### Key facts (verified)

- GitHub: 17 stars · 2 forks · pushed 2026-05-05.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `agent-tool install --safe-approve`.

## Main

- Use `agent-tool install --safe-approve` to register with detected agents while limiting auto-approval to local file tools (README lists the safety tiers).

- When encoding matters (EUC-KR / Shift-JIS / GB18030), set a fallback encoding via `--fallback-encoding` or env var as shown in README.

- Treat it as a tool unifier: README frames it as bundling many tools into one install so agents stop reconfiguring per-project utilities.

### Source-backed notes

- README lists auto-install commands: `agent-tool install`, `--safe-approve`, and `--no-auto-approve`.
- README includes manual MCP config examples for Claude Code/Cursor/Codex (`mcpServers` JSON or `[mcp_servers.*]` TOML).
- README explains it addresses indentation and encoding corruption issues in built-in file tools.

### FAQ

- **Is safe mode recommended?**: README recommends `--safe-approve` when you only want local file tools auto-approved.
- **Can I configure it manually?**: Yes — README shows JSON/TOML examples for different clients.
- **How do I handle non-UTF-8 repos?**: Set `--fallback-encoding` or `AGENT_TOOL_FALLBACK_ENCODING` as shown in README.

## Source & Thanks

> Source: https://github.com/knewstimek/agent-tool
> License: MIT
> GitHub stars: 17 · forks: 2

---

<!-- ZH -->

## Quick Use

```bash
# install from GitHub Releases (see repo) then:
agent-tool install --safe-approve
# Codex config example:
# [mcp_servers.agent-tool] command = "/path/to/agent-tool"
agent-tool --fallback-encoding EUC-KR
```

## Intro

agent-tool 是 MCP 工具服务器，用编码感知/缩进安全的文件操作替代内置工具，并提供一键安装到 Claude Code、Codex、Cursor 等多种 agent 的流程，适合含非 UTF-8 文件的项目。

**Best for:** 包含非 UTF-8 文件、或对缩进/格式要求严格的代码库

**Works with:** 任意 MCP 客户端；README 提到可自动安装到 Claude Code/Codex/Cursor/Cline 等

**Setup time:** 5-12 minutes

### Key facts (verified)

- GitHub：17 stars · 2 forks；最近更新 2026-05-05。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`agent-tool install --safe-approve`。

## Main

- 用 `agent-tool install --safe-approve` 自动注册到已检测到的 agent，同时把自动授权限制在本地文件工具（README 有安全档位说明）。

- 遇到 EUC-KR/Shift-JIS/GB18030 等编码时，按 README 用 `--fallback-encoding` 或环境变量设置兜底编码。

- 把它当作“工具合并器”：README 强调一次安装提供大量工具，避免每个项目重复装 Redis/MySQL/SSH 等工具链。

### Source-backed notes

- README 给出自动安装命令：`agent-tool install`、`--safe-approve`、`--no-auto-approve`。
- README 提供手动 MCP 配置示例：Claude Code/Cursor 的 JSON 与 Codex 的 TOML。
- README 说明它用于解决内置文件工具的缩进与编码损坏问题。

### FAQ

- **推荐用 safe 模式吗？**：README 推荐 `--safe-approve` 只自动授权本地文件工具。
- **能手动配置吗？**：能。README 给出不同客户端的 JSON/TOML 示例。
- **非 UTF-8 项目怎么处理？**：按 README 设置 `--fallback-encoding` 或环境变量 `AGENT_TOOL_FALLBACK_ENCODING`。

## Source & Thanks

> Source: https://github.com/knewstimek/agent-tool
> License: MIT
> GitHub stars: 17 · forks: 2


---
Source: https://tokrepo.com/en/workflows/agent-tool-encoding-safe-mcp-tools-for-agents
Author: MCP Hub