🚀 仓库转文本 - MCP服务器

这是一个用于分析并转换Git仓库为结构化文本文件的MCP服务器，能为大型语言模型（LLM）提供仓库上下文，助力其更好地理解和处理相关信息。

🚀 快速开始

安装所需的包

pip install -r requirements.txt
npm install

启动服务器

node smithery-wrapper.js

服务器地址

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

✨ 主要特性

• 仓库分析：可对本地和远程Git仓库进行分析。
• 结构化输出：生成的格式化文本包含文件夹结构和文件内容拼接。
• 文件过滤：能依据扩展名来包含或排除文件。
• 令牌管理：可通过令牌数量限制输出大小。
• 轻松集成：专为与Cursor的MCP系统无缝协作而设计。
• 跨平台：在Windows、macOS和Linux系统上均可使用。

📦 安装指南

先决条件

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

安装选项

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

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

💻 使用示例

转换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了解指南。

致谢

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

📄 许可证

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