Skip to content

README-for-developer.md

Latest commit

 

History

History
113 lines (90 loc) · 2.15 KB

README-for-developer.md

File metadata and controls

113 lines (90 loc) · 2.15 KB

開発者向け情報

テスト実行

uv run pytest

リンター実行

uv run ruff check .
uv run mypy ./src

ローカル環境で MCP サーバー実行

Claude Desktop アプリケーションのclaude_desktop_config.jsonを以下のように設定します：

{
  "mcpServers": {
    "middleman": {
      "command": "/path/to/python",
      "args": ["/path/to/middleman_ai/mcp/server.py"],
      "env": {
        "MIDDLEMAN_API_KEY": "xxxxx",
        "MIDDLEMAN_BASE_URL": "http://0.0.0.0:8000"
      }
    }
  }
}

PyPI テスト環境で MCP サーバー実行

⚠ 配布直後、最新のバージョンが反映されるまで数分かかることがあります。

{
  "mcpServers": {
    "middleman": {
      "command": "uvx",
      "args": [
        "--index-url",
        "https://test.pypi.org/simple/",
        "--extra-index-url",
        "https://pypi.org/simple/",
        "--index-strategy",
        "unsafe-best-match",
        "--from",
        "middleman-ai",
        "mcp-server"
      ],
      "env": {
        "MIDDLEMAN_API_KEY": "xxxxx",
        "MIDDLEMAN_BASE_URL": "${各環境のAPIベースURL}"
      }
    }
  }
}

配布

事前に PyPI アカウントを作成し、~/.pypircに以下を記述。

[distutils]
index-servers =
  pypi
  pypitest

[pypi]
repository: https://upload.pypi.org/legacy/
username: __token__
password: <APIキー>

[pypitest]
repository: https://test.pypi.org/legacy/
username: __token__
password: <APIキー>

# mainブランチにいるかを確認
git branch

# 事前にテストを実行
uv run pytest

# 事前にpyproject.tomlのversionを更新
cat pyproject.toml | grep version

# 古いビルド成果物を削除
rm -rf dist/
rm -rf build/
rm -rf middleman_ai.egg-info/

# 設定が正しいか事前チェック
uv run python setup.py check

# ビルド
uv run python setup.py sdist
uv run python setup.py bdist_wheel

# descriptionの形式が正しいかチェック
uv run twine check dist/*

# 配信
uv run twine upload --repository pypitest dist/* # テスト用
uv run twine upload --repository pypi dist/* # 本番用