repo-to-txt-mcp

repo-to-txt-mcp

Git リポジトリを分析し、LLM のコンテキスト用のテキストファイルに変換する MCP サーバーです。

概要

repo-to-txt-mcp は、GitHub リポジトリやローカルフォルダーを分析し、構造化されたテキストファイルに変換できるマシンコードプロトコル（MCP）サーバーです。GPT-4 のような大規模言語モデル（LLM）にリポジトリのコンテキストを提供する際に特に便利です。

このプロジェクトは、repo-to-txt CLI ツールの機能を拡張し、他のアプリケーション、特に Cursor の MCP システムに統合できるウェブ API を提供します。

機能

• リポジトリの分析：ローカルおよびリモートの Git リポジトリを分析します
• 構造化された出力：フォルダー構造と連結したファイル内容を含む、整形済みのテキストを生成します
• ファイルのフィルタリング：拡張子に基づいてファイルを含める、または除外します
• トークン管理：トークン数によって出力サイズを制限します
• 簡単な統合：Cursor の MCP システムとシームレスに連携するように設計されています
• クロスプラットフォーム：Windows、macOS、Linux で動作します

インストール

前提条件

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

インストール方法

詳細な手順については、インストールガイドを参照してください。

• 直接インストール
• Docker によるインストール
• GitHub Container Registry の使用

クイックスタート

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 との統合

このプロジェクトには、MCP を管理するツールである Smithery の設定が含まれています。

smithery install chromewillow/repo-to-txt-mcp

貢献

貢献を歓迎します。ガイドラインについては、CONTRIBUTING.mdを参照してください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

謝辞

• このプロジェクトは、repo-to-txt CLI ツールの機能を基盤としています
• MCP サーバーの作成を簡素化してくれた FastMCP ライブラリに感謝します