Model Context Protocol / Coding Agent

独学書

コンテンツ

MCP入門

生成AIアプリの開発手順の修得

• ソースコード

• 進捗

  Contents	Finished
  第1章 MCPを30分で体験する	2025/12/13
  第3章 最初のMCPサーバを作る	2025/12/14
  第5章 MCPをもっと便利に使う2つの通信方式	2025/12/16
  第6章 データベース連携サーバ	2025/12/23
  第7章 外部API連携サーバ	2026/01/02
  第8章 汎用MCPツール群を作る	2026/01/17
  第9章 MCPホストを自作する	2026/01/17
  第10章 MCPエージェントを作る	2026/01/18

AI駆動開発入門

AIエージェントを活用した開発スタイルの修得

• 進捗

  Contents	Finished
  Chapter 1 Claude Code入門と開発環境構築	2026/01/24
  Chapter 2 Claude CodeによるAI駆動開発の基礎	2026/01/25
  Chapter 3 MCPを活用したAIチャットボット開発	2026/01/30
  Chapter 4 並行処理とサブエージェントを使った開発手法	2026/02/15

  • TODOアプリ作成

    • GitHub Pages
    • Vercel

  • AIチャットボット

    • Google Cloud
    • MongoDB Atlas

  • 営業日報システム

    • 開発環境サーバ構築 <<2026/02/08 finished>>
    • 基本実装 <<2026/02/15 finished>>
    • 残課題対応 <<2026/03/17 finished>>
    • Playwright対応 <<2026/04/01 started>>

環境

基本環境

MCP入門

AI駆動開発入門

• 営業日報システム

• AIチャットボット

• TODOアプリ

ノウハウ

基本構成

Gemini

• 依頼用プロンプト例

Open AI

• Open AI API利用
  • APIキーの作成

Claude AI

• Claude Code 2.1.101 <<2026/04/11 updated from 2.1.100>>

  • インストール

    irm https://claude.ai/install.ps1 | iex

  • 起動

    claude

  • 更新

    claude update

  • 共通スキル管理手順
  • スキル実践例
    • 次に取り組むべき作業
    • 実装作業
      • 開発ノート確認
      • 実装内容把握
      • 完了後の振り返り
    • レビュー作業 / 結果報告
  • VSCode拡張機能を強制的に更新する方法

    $env:NODE_OPTIONS=""
    code --install-extension Anthropic.claude-code --force

  • 不具合報告 [BUG] Claude generates unnatural Japanese compound words by literal translation from English <<2026/02/21 posted>>
    • Windowsで起動できない不具合あり(2.1.51) <<2026/02/24 happened>>
      • Claude Desktopでの調査の結果、Linux依存のパスが含まれていたためと判明 -> 2.1.49にダウングレード
    • macOSで日時を取得する際、currentDateを参照し、時刻まで取得しない不具合あり(2.1.56)

• Claude Desktopの設定

  • 「ファイル」ー「設定」メニューから設定画面を開く
  • 設定画面の「設定」ー「開発者」タブの「設定を編集」から行う
  • 設定を反映するために、システムトレイに常駐するClaude Desktopを終了し、再起動する
  • Web検索の無効化

• MCPサーバの作成(fastmcp)

  uv add fastmcp

  fastmcp 追加ログ

  Using CPython 3.14.2 interpreter at: C:\Users\taish\AppData\Local\Programs\Python\Python314\python.exe
  Creating virtual environment at: .venv
  Resolved 88 packages in 773ms
  Prepared 85 packages in 2.48s
  ░░░░░░░░░░░░░░░░░░░░ [0/85] Installing wheels...                                                                                             warning: Failed to hardlink files; falling back to full copy. This may lead to degraded performance.                                         
          If the cache and target directories are on different filesystems, hardlinking may not be supported.                                 
          If this is intentional, set `export UV_LINK_MODE=copy` or use `--link-mode=copy` to suppress this warning.                          
  Installed 85 packages in 1.00s
  + annotated-types==0.7.0
  + anyio==4.12.0
  + attrs==25.4.0
  + authlib==1.6.6
  + beartype==0.22.9
  + cachetools==6.2.3
  + certifi==2025.11.12
  + cffi==2.0.0
  + charset-normalizer==3.4.4
  + click==8.3.1
  + cloudpickle==3.1.2
  + colorama==0.4.6
  + cryptography==46.0.3
  + cyclopts==4.3.0
  + diskcache==5.6.3
  + dnspython==2.8.0
  + docstring-parser==0.17.0
  + docutils==0.22.3
  + email-validator==2.3.0
  + exceptiongroup==1.3.1
  + fakeredis==2.32.1
  + fastmcp==2.14.0
  + h11==0.16.0
  + httpcore==1.0.9
  + httpx==0.28.1
  + httpx-sse==0.4.3
  + idna==3.11
  + importlib-metadata==8.7.0
  + jaraco-classes==3.4.0
  + jaraco-context==6.0.1
  + jaraco-functools==4.3.0
  + jsonschema==4.25.1
  + jsonschema-path==0.3.4
  + jsonschema-specifications==2025.9.1
  + keyring==25.7.0
  + lupa==2.6
  + markdown-it-py==4.0.0
  + mcp==1.24.0
  + mdurl==0.1.2
  + more-itertools==10.8.0
  + openapi-pydantic==0.5.1
  + opentelemetry-api==1.39.1
  + opentelemetry-exporter-prometheus==0.60b1
  + opentelemetry-instrumentation==0.60b1
  + opentelemetry-sdk==1.39.1
  + opentelemetry-semantic-conventions==0.60b1
  + packaging==25.0
  + pathable==0.4.4
  + pathvalidate==3.3.1
  + platformdirs==4.5.1
  + prometheus-client==0.23.1
  + py-key-value-aio==0.3.0
  + py-key-value-shared==0.3.0
  + pycparser==2.23
  + pydantic==2.12.5
  + pydantic-core==2.41.5
  + pydantic-settings==2.12.0
  + pydocket==0.15.5
  + pygments==2.19.2
  + pyjwt==2.10.1
  + pyperclip==1.11.0
  + python-dotenv==1.2.1
  + python-json-logger==4.0.0
  + python-multipart==0.0.20
  + pywin32==311
  + pywin32-ctypes==0.2.3
  + pyyaml==6.0.3
  + redis==7.1.0
  + referencing==0.36.2
  + requests==2.32.5
  + rich==14.2.0
  + rich-rst==1.3.2
  + rpds-py==0.30.0
  + shellingham==1.5.4
  + sortedcontainers==2.4.0
  + sse-starlette==3.0.3
  + starlette==0.50.0
  + typer==0.20.0
  + typing-extensions==4.15.0
  + typing-inspection==0.4.2
  + urllib3==2.6.2
  + uvicorn==0.38.0
  + websockets==15.0.1
  + wrapt==1.17.3
  + zipp==3.23.0

• MCPサーバの検証(inspector)

  npx @modelcontextprotocol/inspector uv run python <filename>

  • 初期画面(localhost:6277でサーバが起動した後、自動でブラウザが起動)
  • 接続 / ツール一覧確認
  • ツール実行
  • 結果確認

• 仲介ツール for Claude Desktop

  • mcp-remote
    • Claude Desktopでhttp接続するための設定(claude_desktop_config.json)

      {
        "mcpServers": {
          "calculator-http": {
            "command": "npx",
            "args": ["mcp-remote@latest", "http://localhost:8000/mcp"]
          }
        }
      }

  • mcp-proxy

    uv tool install mcp-proxy

• 外部API

  • OpenWeather API
    • API Keyは下記リンクから取得する
    • 取得後、有効になるまで待つ（無効の場合、401認証エラーとなる）
  • News API
    • API Keyは下記リンクから取得する
  • Tavily
    • API Keyは下記画面に表示のキーを使用する

• 指示ファイル

  • CLAUDE.md
  • instructions.md

• Claude Codeスキル

  • スキルとは、Claude Codeで繰り返し使用するワークフローをカスタムコマンドとして定義する機能
  • 作成手順
    1. プロジェクトルートに .claude/skills ディレクトリを作成
    2. スキルファイル（Markdown形式）を作成
       • ファイル名がスキル名になる（例: update-digest.md → /update-digest）
    3. Claude Codeで /スキル名 と入力して実行