🔌 byebye-docs MCP Server

Claude CodeやClaude Desktopと連携するMCPサーバー。

コードとドキュメントの同期？AIにやらせろ。

🚀 インストール

pip install byebye-docs-mcp
# または
uv tool install byebye-docs-mcp

以上。終わり。

⚡ クイックスタート

既存プロジェクトに導入

curl -sL https://raw.githubusercontent.com/pon-tanuki/byebye-docs/main/scripts/init-project.sh | bash -s /path/to/your-project

これで .agent/ と CLAUDE.md と .mcp.json が全部セットアップされる。

手動でやりたい人

# 1. インストール（上でやった）

# 2. テンプレートをコピー
git clone --depth 1 https://github.com/pon-tanuki/byebye-docs.git /tmp/byebye-docs
cp -r /tmp/byebye-docs/.agent /path/to/your-project/
cp /tmp/byebye-docs/CLAUDE.md /path/to/your-project/

# 3. .mcp.json を作成（下記参照）

🔧 Claude Codeでの設定

プロジェクトルートに .mcp.json を置く：

{
  "mcpServers": {
    "byebye-docs": {
      "command": "byebye-docs",
      "env": {
        "BYEBYE_DOCS_PROJECT_PATH": "."
      }
    }
  }
}

🛠️ できること

コード↔ドキュメント同期（目玉機能）

ドキュメント管理

リソース

プロンプト

💡 使用例

コードとドキュメントの差分をチェック

diff_code_docs(
    code_path="src/",
    doc_type="all",     # "api", "entities", "all"
    language="auto"
)

「お前のドキュメント、コードと合ってないぞ」って教えてくれる。

コードから情報を抽出

extract_from_code(
    code_path="src/",
    extract_type="all",
    output_format="yaml",
    merge_with_existing=True   # 既存ドキュメントとマージ
)

FastAPI のルートとか Pydantic のモデルとか、Express のルートとか TypeORM のエンティティとか、勝手に拾ってYAMLにしてくれる。

ドキュメントを自動同期

# まずプレビュー（何が変わるか確認）
auto_sync(mode="preview", code_path="src/")

# 問題なさそうなら適用
auto_sync(mode="apply", code_path="src/", target_docs=["api.yaml", "entities.yaml"])

バックアップも勝手に取ってくれる。安心。

テンプレートからドキュメント作成

create_document(
    template_type="context.yaml",
    output_path=".agent/context.yaml",
    metadata={
        "project_name": "My Awesome Project",
        "author": "Claude Agent"
    }
)

🔄 更新方法

pip install --upgrade byebye-docs-mcp
# または
uv tool install byebye-docs-mcp --force

🌍 環境変数

🧑‍💻 開発者向け

ソースからビルド

git clone https://github.com/pon-tanuki/byebye-docs.git
cd byebye-docs/mcp-server
uv sync

テスト

uv run pytest

Lint

uv run ruff check .
uv run ruff format .

🐍 対応言語（コード解析）

Python

• FastAPI / Flask のルート検出
• SQLAlchemy / Pydantic / dataclass のエンティティ検出

TypeScript / JavaScript

• Express.js / NestJS のルート検出
• TypeORM のエンティティ検出
• Prisma モデル（.prisma ファイル）
• TypeScript interface / type alias

他の言語？PRウェルカム。

📄 ライセンス

MIT — 好きに使って。