仓库转文本-MCP服务器

一个用于分析并转换Git仓库为结构化文本文件的MCP服务器，以便大型语言模型（LLM）获取上下文。

概述

repo-to-txt-mcp 是一个机器代码协议（MCP）服务器，允许您分析GitHub仓库或本地文件夹，并将其转换为结构化的文本文件。这对于向像GPT-4这样的大型语言模型提供仓库上下文特别有用。

该项目扩展了repo-to-txt CLI工具的功能，以提供一个Web API，可以与其他应用程序集成，特别是Cursor的MCP系统。

特性

• 仓库分析：分析本地和远程Git仓库
• 结构化输出：生成包含文件夹结构和文件内容拼接的格式化文本
• 文件过滤：根据扩展名包含或排除文件
• 令牌管理：通过令牌数量限制输出大小
• 轻松集成：设计为与Cursor的MCP系统无缝工作
• 跨平台：适用于Windows、macOS和Linux

安装

先决条件

• Python 3.8+
• Node.js 14+
• Git

安装选项

有关详细安装说明，请参阅安装指南：

• 直接安装
• Docker安装
• GitHub容器注册表使用

快速开始

1. 安装所需的包：

   pip install -r requirements.txt
   npm install
   

2. 启动服务器：

   node smithery-wrapper.js
   

3. 服务器将在http://localhost:8000可用

API 使用

转换GitHub仓库

curl -X POST http://localhost:8000/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "source": "https://github.com/username/repository",
    "return_file": true
  }'

根据文件扩展名过滤

curl -X POST http://localhost:8000/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "source": "https://github.com/username/repository",
    "include_only": [".py", ".js", ".md"],
    "exclude": [".pyc", ".git"]
  }'

有关完整详细信息，请参阅API文档。

Cursor 集成

此服务器设计用于与Cursor集成，以便在对话期间向语言模型提供仓库上下文。

有关设置和使用此功能的说明，请参阅Cursor集成指南。

Docker 支持

包含Dockerfile以促进容器化部署：

docker build -t repo-to-txt-mcp .
docker run -p 8000:8000 repo-to-txt-mcp

Smithery 集成

该项目包括Smithery的配置，用于管理MCP：

smithery install chromewillow/repo-to-txt-mcp

贡献

欢迎贡献！请参阅CONTRIBUTING.md了解指南。

许可证

此项目根据MIT许可证发布 - 有关详细信息，请参阅LICENSE文件。

致谢

• 此项目基于repo-to-txt CLI工具的功能构建
• 感谢FastMCP库简化了MCP服务器的创建