MCPサーバー構築の泥沼:AIエージェントの理解不足とIDEの不安定さを越えて
AIエージェントの無理解とIDEの不安定さに翻弄された実録。MCPサーバー構築における「実行環境の喪失」という落とし穴と、その解決策。
14 articles
AIエージェントの無理解とIDEの不安定さに翻弄された実録。MCPサーバー構築における「実行環境の喪失」という落とし穴と、その解決策。
Model Context Protocol (MCP) の「サーバー」という呼称が生む誤解と、stdioモードの実態について。なぜ接続トラブルで環境依存が起きるのかの技術的背景。
Python/uv環境で実装した自作スクリプトを、MCPサーバーとして安全かつ確実にAIエージェントへ提供するための実践的な構築手順。
正規表現の単語境界 (\b) が、日本語と英語が混在する技術文章において期待通りに動かない理由と、それを解決する先読み・後読みの実踐的パターン。
パッケージマネージャーという開発基盤そのものをAIエージェントに開放する。uvとpnpmがもたらす「試行錯誤の場」がいかに自律的な自動化を実現するか。
静的サイト運用で避けられない「参照されていない画像資産」の蓄積。MarkdownとR2を全走査して不要な資産を特定・一括削除するクリーンアップツールの実装について。
Astroへの移行において、私が最もこだわったのが「執筆体験」です。画像のアップロードやリンクの書き換えといった面倒な作業を全自動化する、自作のPythonスクリプト「manager.py」の内部構造と、そこで使われている泥臭い正規表現テクニックを解説します。
AIエージェントにブログ運用を任せていたら、バックグラウンドでサーバープロセスが無限増殖していた話。ポート自動インクリメント機能との戦いと、Pythonによる「場所奪い取り」スクリプトの実装。
Node.jsプロジェクトであるAstroの管理に、なぜあえてPythonスクリプト(manager.py)を採用したのか。
AIエージェントと共創するブログ運用において、品質担保をどう自動化するか。textlintではなくPythonで独自のLinterを実装した理由と詳細。
ブログ執筆の摩擦をゼロにするために。PythonとCloudflare R2を用いて、マークダウンに画像を貼るだけで最適化・アップロードされるパイプラインを構築する。
「記事を書く→コマンド一発でデプロイ」を実現するために、Astro + Cloudflare Pages + R2 を組み合わせた独自CMSを構築しました。プロジェクト単位での記事管理、Pythonスクリプトによる画像処理、そして爆速のデプロイフローの全貌を公開します。
執筆環境をコックピット化する。Pythonスクリプトを呼び出すだけの「薄い」VS Code拡張機能を自作し、エディタから一撃で記事を公開する仕組みを作る。(過去記事アーカイブ)
AI時代のアウトプット基盤としてBloggerを再評価する。MarkdownからHTMLへの変換とAPI投稿を自動化するPythonパイプラインの実装。(過去記事アーカイブ)