portfolio-mcp-server

https://github.com/user-attachments/assets/4c1b844a-087f-48a6-b156-bdef27282acc

セットアップからツール呼び出し、リアルタイムの回答までを一通り紹介します。

claude mcp add --scope user portfolio -- uvx --with "mcp<2" portfolio-mcp-server

設定ファイルを開きます。

ファイルにすでにmcpServersキーがある場合は、ファイル全体を上書きせず、その中に"portfolio"を追加してください。

pipでインストールした場合：

{
  "mcpServers": {
    "portfolio": {
      "command": "portfolio-mcp-server"
    }
  }
}

クローンしたチェックアウトから実行する場合（server.pyの絶対パスを使用してください）：

{
  "mcpServers": {
    "portfolio": {
      "command": "python",
      "args": ["/absolute/path/to/portfolio-mcp-server/server.py"]
    }
  }
}

Claude Desktopを再起動し、「AyushはFastAPIを使ってどのようなプロジェクトを作りましたか？」と尋ねてください。

stdioサーバーを起動できるMCPクライアントであれば使用できます。サーバーコマンドには、portfolio-mcp-server（pip installの実行後）または上記のuvxコマンドを指定してください。

git clone https://github.com/ayush-s-tomar/portfolio-mcp-server.git
cd portfolio-mcp-server

python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate

pip install -r requirements.txt

MCP Inspectorで対話的にテストできます。

mcp dev server.py

ブラウザーのUIが開き、各ツールを呼び出して、リクエストとレスポンスの生のペイロードを確認できます。

すべてのプッシュとプルリクエストで、GitHub Actionsが次のチェックを実行します。

PRを作成する前に、同じチェックをローカルで実行してください。

pip install -r requirements-dev.txt
ruff check .
mypy server.py
pytest

.github/workflows/ci.ymlを参照してください。

portfolio-mcp-server/
|-- portfolio_mcp_server/
|   |-- __init__.py
|   `-- server.py          # packaged module (what PyPI ships)
|-- server.py              # top-level entry point (dev / MCP Inspector / CI)
|-- tests/
|   |-- smoke_test.py      # stdio smoke test: calls all 5 tools, validates JSON schema
|   |-- test_tools.py      # per-tool tests
|   |-- test_data.py       # data integrity checks for the bundled projects
|   `-- check_links.py     # checks every URL in the data (runs weekly in CI)
|-- assets/                # demo GIF and screenshots
|-- .github/
|   |-- workflows/         # ci.yml, links.yml
|   |-- ISSUE_TEMPLATE/
|   |-- PULL_REQUEST_TEMPLATE.md
|   `-- dependabot.yml
|-- pyproject.toml         # PyPI packaging config
|-- server.json            # MCP registry manifest
|-- requirements.txt
|-- requirements-dev.txt
|-- claude_desktop_config_snippet.json
|-- CHANGELOG.md
|-- CONTRIBUTING.md
|-- SECURITY.md
`-- LICENSE