# リポジトリをクローン
git clone <your-repo-url>
cd mcp_python

# 依存関係をインストール
poetry install

# 開発依存関係も含む
poetry install

pip install -e .

# ドキュメントディレクトリを指定
export MCP_DOCS_DIR=/path/to/your/documents

# サーバー起動
poetry run python -m mcp_server.main

# または Makefile を使用
make run

# イメージをビルド
docker build -t mcp-document-server:latest .

# 実行（docsディレクトリをマウント）
docker run -it --rm \
  -v $(PWD)/docs:/app/docs:ro \
  mcp-document-server:latest

# または Makefile を使用
make docker-build
make docker-run

docker-compose up -d

{
  "mcpServers": {
    "document-server": {
      "command": "poetry",
      "args": ["run", "python", "-m", "mcp_server.main"],
      "env": {
        "MCP_DOCS_DIR": "/path/to/your/documents"
      }
    }
  }
}

{
  "mcpServers": {
    "document-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/your/documents:/app/docs:ro",
        "mcp-document-server:latest"
      ]
    }
  }
}

# すべてのテストを実行
poetry run pytest

# カバレッジ付きで実行
poetry run pytest --cov=src/mcp_server --cov-report=html

# または Makefile を使用
make test
make test-cov

npx @modelcontextprotocol/inspector poetry run python -m mcp_server.main

# または Makefile を使用
make inspect

mcp_python/
├── src/
│   └── mcp_server/
│       ├── __init__.py
│       ├── server.py          # メインサーバー
│       ├── main.py            # エントリーポイント
│       ├── tools/
│       │   └── document.py    # ドキュメントツール
│       ├── resources/
│       │   └── file_handler.py # 安全なファイル操作
│       └── utils/
│           └── logging.py     # ロギング設定
├── tests/                     # テストファイル
├── docs/                      # ドキュメントディレクトリ
├── Dockerfile                 # Docker設定
├── docker-compose.yml         # Docker Compose設定
├── pyproject.toml            # プロジェクト設定
├── pytest.ini                # Pytest設定
├── Makefile                  # 便利コマンド
└── README.md

# リンター実行
poetry run ruff check src/ tests/

# 自動フォーマット
poetry run ruff format src/ tests/

# または Makefile を使用
make lint
make format

make clean

# イメージをビルド
docker build -t your-org/mcp-document-server:latest .

# Docker Hub にログイン
docker login

# プッシュ
docker push your-org/mcp-document-server:latest

# イメージを取得
docker pull your-org/mcp-document-server:latest

{
  "mcpServers": {
    "document-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/documents:/app/docs:ro",
        "your-org/mcp-document-server:latest"
      ]
    }
  }
}

# ❌ これはNG（JSON-RPCメッセージが壊れる）
print("Debug message")

# ✅ これはOK
logger.info("Debug message")  # stderr に出力

ユーザー: プロジェクトのドキュメントにはどんなものがありますか？

Claude: (list_documentsツールを使用)
以下のドキュメントが利用可能です：
- README.md
- docs/api.md
- docs/setup.md

ユーザー: setup.mdの内容を教えてください

Claude: (get_documentツールを使用してドキュメントを取得し、内容を説明)