内容
# AgentTools — Python 脚本工具集 (MCP Server)
[](https://python.org)
[](LICENSE)
> 通过 **MCP (Model Context Protocol)** 将本地 Python 工具脚本暴露给 AI 客户端（如 Claude Desktop）调用的工具集。
---
## 📦 功能概述
| 工具 | 功能 | 适用场景 |
| --- | --- | --- |
| **tree_to_txt** | 扫描目录生成文件树，保存为文本文件 | 项目结构概览、文档编写 |
| **xlsx_to_txt** | 读取所有 `.xlsx` Excel 文件，提取内容转文本 | 将表格数据提供给 AI 处理 |
| **python_to_txt** | 提取所有 `.py` 文件代码，合并到一个文本文件 | 代码审查、AI 上下文准备 |
| **text_to_txt** | 自动检测编码，合并所有文本文件 | 文档汇总、语料整理 |
所有工具在扫描目录时自动跳过 `.venv`、`__pycache__`、`.git` 等目录，并尊重 `.gitignore` 配置。
---
## 🚀 快速开始
### 1. 安装依赖
本项目使用 [uv](https://docs.astral.sh/uv/) 管理依赖：
```bash
uv sync
```
### 2. 配置 MCP 客户端
将以下 JSON 添加到你的 MCP 客户端配置中（如 Claude Desktop `claude_desktop_config.json`）：
```json
{
"mcpServers": {
"python-script-runner": {
"command": "path\\to\\.venv\\Scripts\\python.exe",
"args": [
"path\\to\\mcp_server.py"
]
}
}
}
```
> ⚠️ 请将 `path\\to\\` 替换为你的实际项目路径。
### 3. 运行测试
```bash
python mcp_server.py
```
---
## 🛠️ 工具详情
### tree_to_txt
```bash
python tree_to_txt.py # 扫描当前目录
python tree_to_txt.py -d /path/to/project # 指定目录
python tree_to_txt.py -o tree.txt # 自定义输出文件名
```
### xlsx_to_txt
```bash
python xlsx_to_txt.py # 读取当前目录所有 xlsx
python xlsx_to_txt.py --raw-formulas # 提取公式原文
python xlsx_to_txt.py --max-rows 100 # 限制行数
```
### python_to_txt
```bash
python python_to_txt.py # 提取所有 .py 文件
```
### text_to_txt
```bash
python text_to_txt.py # 合并所有文本文件
```
---
## 📄 LICENSE
本项目基于 [MIT License](LICENSE) 开源。
