Micah Boswell

micah-boswell-mcp

テキサス州ダラスのプロダクトデザインリーダー、Micah Boswell に関する質問に回答する、公開 Model Context Protocol（MCP）サーバーです。MCP 対応のエージェント（Claude、ChatGPT、Cursor など）が 1 つの URL に接続し、本人のページに掲載されている情報を取得できます。

• エンドポイント：https://micah-boswell-mcp.vercel.app/mcp（ストリーミング可能な HTTP、ステートレス、認証不要）
• ランディングページ：https://micah-boswell-mcp.vercel.app/
• レジストリマニフェスト：https://micah-boswell-mcp.vercel.app/server.json（`io.github.socraticstatic/micah-boswell`）、および /.well-known/mcp/server-card.json
• プレーンテキスト：https://micah-boswell-mcp.vercel.app/llms.txt
• 稼働確認：https://micah-boswell-mcp.vercel.app/healthz

ツール

ツール	返される内容
about_micah_boswell	1 段落と主要情報のリスト
micah_boswell_facts	構造化された全レコード（data/facts.json）
micah_boswell_profiles	検証済みプロフィール 23 件（sameAs）とラベル
micah_boswell_work	1998 年から現在までの役職、受賞歴、学歴、AT&T での業務
micah_boswell_writing	エッセイ、URL 付きの全 29 編の詩、Medium、LinkedIn、Quora、dev.to
micah_boswell_poem(slug)	1 編の詩。conscious-shell.com/poems/<slug> からライブ取得
micah_boswell_photography(limit?)	Unsplash の統計情報と人気の写真
micah_boswell_faq(query?)	16 件の質問と回答のペア。絞り込み可能
search_micah_boswell(query)	llms-full.txt の段落検索とソース URL

リソース：micah://llms.txt、micah://llms-full.txt、micah://facts.json。

接続

Claude Code：

claude mcp add --transport http micah-boswell https://micah-boswell-mcp.vercel.app/mcp

Claude Desktop / claude.ai：Settings、Connectors、Add custom connector の順に選択し、URL を貼り付けます。

ChatGPT：Settings、Connectors、Create（developer mode）の順に選択し、認証なしで URL を貼り付けます。

Cursor（.cursor/mcp.json）：

{ "mcpServers": { "micah-boswell": { "url": "https://micah-boswell-mcp.vercel.app/mcp" } } }

構成

api/mcp.js          POST /mcp: fresh stateless StreamableHTTPServerTransport per request
api/healthz.js      GET /healthz
lib/server.js       buildServer(): tools + resources
lib/data.js         loads data/
lib/search.js       paragraph search
lib/poem.js         live poem fetch + CreativeWork JSON-LD parse
data/               bundled sources: llms.txt, llms-full.txt, conscious-shell-llms.txt, photography.json, facts.json
public/             landing page, llms.txt, server.json, icons, robots.txt, sitemap.xml
scripts/dev.mjs     local server mirroring the Vercel routing
test/               vitest

データソース：https://micahboswell.design/llms.txt、https://micahboswell.design/llms-full.txt、https://conscious-shell.com/llms.txt、@micahboswell の Unsplash 統計情報。facts.json はこれらのファイルのみを基に編集されています。キャリア関連のキー（work.roles、awards、certifications.list、education）は、ハブの職歴リストと同じキャリアレコードから node scripts/sync-career.mjs で生成されます。手動で編集しないでください。残りのデータを更新するには、再取得して data/ に保存し、facts.json を更新してテストを実行してください。テストではコンテンツのルール（em dash を使わない、扱わないトピックを含めない）を検証します。

トランスポートに関する注意：mcp-handler 2.x では SDK の v2 パッケージが必要で、1.x は Next.js に依存するため、このサーバーではステートレス JSON モードで @modelcontextprotocol/sdk 1.x の StreamableHTTPServerTransport を手作業で実装しています。gpsail-mcp 関数と同じ形式です。

開発

npm install
npm test          # vitest: tool handlers, HTTP transport, content rules
npm run dev       # http://localhost:3939  (MCP at /mcp)

デプロイ

vercel --prod --yes

リリース

バージョンは 3 か所で管理されており、値が一致しないとテストは失敗します。server.json（ルートにあり、mcp-publisher が読み込みます。public/server.json は配信用コピーです）、package.json、lib/data.js の VERSION（ライブサーバーが報告するバージョン）です。

1. 3 か所すべてのバージョンを更新します。情報に変更があれば data/ を更新し、facts.json の lastUpdated も更新します。
2. npm test を実行し、続けて vercel --prod --yes を実行してから、https://micah-boswell-mcp.vercel.app/healthz が新しいバージョンを報告することを確認します。
3. git tag v<version> && git push origin main v<version> を実行します。

その後、.github/workflows/publish-mcp.yml が GitHub OIDC を使って、カードを公式 MCP Registry（io.github.socraticstatic/micah-boswell）に公開します。カードのバージョン、またはライブサーバーが報告するバージョンと一致しないタグは拒否されます。.github/workflows/ci.yml はプッシュのたびにテストを実行します。

掲載先：公式レジストリ、Smithery、Glama。カードは /.well-known/mcp/server-card.json でも配信されます。

ライセンス

MIT。Micah Boswell に関する事実は本人によるものです。https://micahboswell.design/ を引用してください。