Micah Boswell

micah-boswell-mcp

一个公开的模型上下文协议（MCP）服务，可回答有关 Micah Boswell 的问题。他是位于德克萨斯州达拉斯的产品设计负责人。任何兼容 MCP 的 Agent（Claude、ChatGPT、Cursor 等）只需连接一个 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	一段介绍以及关键事实列表
micah_boswell_facts	完整的结构化记录（data/facts.json）
micah_boswell_profiles	23 个经验证的个人资料（sameAs）及其标签
micah_boswell_work	1998 年至今的职位、奖项、教育经历和 AT&T 工作经历
micah_boswell_writing	文章、全部 29 首带 URL 的诗、Medium、LinkedIn、Quora、dev.to
micah_boswell_poem(slug)	一首诗，从 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（开发者模式），然后粘贴 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，然后运行测试。测试会强制执行内容规则（不得使用长破折号，不得涉及禁止话题）。

传输说明：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

发布

版本号分别保存在三个位置，若它们不一致，测试就会失败：server.json（根目录文件，由 mcp-publisher 读取；public/server.json 是实际提供的副本）、package.json 和 lib/data.js 中的 VERSION（实时服务报告的版本号）。

1. 更新这三处的版本号。如果事实有变化，请更新 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 注册表（io.github.socraticstatic/micah-boswell）。如果标签与服务卡或实时服务报告的版本不一致，该工作流会拒绝发布。.github/workflows/ci.yml 会在每次推送时运行测试。

收录列表：官方注册表、Smithery、Glama。服务卡也可通过 /.well-known/mcp/server-card.json 访问。

许可证

MIT。关于 Micah Boswell 的信息归其本人所有；请引用 https://micahboswell.design/。