repo-to-txt-mcp
2025.03.26
0
Python仓库分析文本转换LLM 上下文开发效率
repo-to-txt-mcp 是一个基于机器代码协议（MCP）的服务，用于分析和将 Git 仓库或本地文件夹转换为结构化的文本文件。该服务特别适用于为大型语言模型（如 GPT-4）提供仓库上下文。它扩展了 repo-to-txt CLI 工具的功能，提供了一个可以集成到其他应用程序中的 Web API，尤其是 Cursor 的 MCP 系统。
View on GitHub
Overview
基本能力
产品定位
repo-to-txt-mcp 是一个用于分析和转换 Git 仓库为文本文件的 MCP 服务，主要用于为大型语言模型提供仓库上下文。
核心功能
- 仓库分析：支持本地和远程 Git 仓库的分析。
- 结构化输出：生成包含文件夹结构和文件内容的格式化文本。
- 文件过滤：根据文件扩展名包含或排除文件。
- 令牌管理：通过令牌计数限制输出大小。
- 易集成：设计用于与 Cursor 的 MCP 系统无缝集成。
- 跨平台：支持 Windows、macOS 和 Linux。
适用场景
- 为大型语言模型提供仓库上下文。
- 在开发工具中集成仓库分析功能。
- 自动化代码文档生成。
工具列表
- repo-to-txt CLI 工具：基础功能，用于本地仓库转换。
- FastMCP 库：简化 MCP 服务器的创建。
- Smithery：用于管理 MCP 的工具。
常见问题解答
- 安装问题：确保满足 Python 3.8+、Node.js 14+ 和 Git 的前置依赖。
- 集成问题：参考 Cursor 集成指南和 API 文档。
使用教程
使用依赖
# 确保已安装 Python 3.8+、Node.js 14+ 和 Git
安装教程
# 安装依赖
pip install -r requirements.txt
npm install
# 启动服务
node smithery-wrapper.js
调试方式
# 检查服务是否运行
curl http://localhost:8000
# 测试仓库转换
curl -X POST http://localhost:8000/analyze -H "Content-Type: application/json" -d '{"source": "https://github.com/username/repository", "return_file": true}'