AI导哈

MCP应用服务器

MCP服务器为ask.archil.io提供工具和交互式应用支持，部署为AWS Lambda函数，提供标准MCP工具和交互式HTML UI的MCP应用。

  • by archil-l
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 archil-l/mcp-ask-archil

使用说明

mcp问阿奇尔

MCP服务器为工具和交互式应用程序供电 ask.archil.io.作为AWS Lambda函数部署，它公开了标准MCP工具和 MCP应用程序 --在对话中直接呈现交互式HTML UI的工具。

可用工具

工具 类型 描述
add-numbers 工具 添加两个数字（演示工具）
get-resume MCP应用程序 交互式PDF简历查看器（从S3获取PDF）
get-architecture MCP应用程序 解释ask.archil.io如何构建的动画架构图
get-archils-work-experience MCP应用程序 Archil专业工作经验和项目的互动概述

MCP应用程序

MCP应用程序是工具+资源对。调用时，该工具返回 resourceUri 指向一个自包含的单文件HTML包。MCP主机获取该资源，并将其呈现在通过AppBridge/PostMessageTransport连接的沙盒iframe中。

图案：

  1. registerAppTool() --将工具注册到 _meta.ui.resourceUri 元数据
  2. registerAppResource() --将编译后的HTML包作为MCP资源提供
  3. 内部的React应用程序使用 useApp 从 @modelcontextprotocol/ext-apps/react 接收工具结果并与主机通信

每个应用程序都是用Vite+React+Tailwind构建的+ vite-plugin-singlefile 变成一个独立的 .html 归档 dist/mcp-lambda/.

项目结构

src/
├── handler.ts                  # Express HTTP server (Lambda Web Adapter)
├── server.ts                   # MCP server — registers all tools + apps
├── tools/                      # Standard MCP tools
│   ├── get-alerts.ts
│   ├── get-forecast.ts
│   └── add-numbers.ts
├── apps/                       # MCP Apps (tool + resource + React UI)
│   ├── get-resume/
│   │   ├── get-resume-app.ts   # Server: registerAppTool + registerAppResource
│   │   ├── vite.config.ts
│   │   ├── get-resume-app.html
│   │   └── src/get-resume-app.tsx
│   ├── get-architecture/
│   │   ├── get-architecture-app.ts
│   │   ├── vite.config.ts
│   │   ├── get-architecture-app.html
│   │   └── src/get-architecture-app.tsx
│   └── get-archils-work-experience/
│       ├── get-archils-work-experience-app.ts
│       ├── vite.config.ts
│       ├── get-archils-work-experience-app.html
│       └── src/get-archils-work-experience-app.tsx
├── types/types.ts              # defineTool factory
├── components/                 # Shared React components (pdf-viewer, ui/)
├── styles/globals.css          # Shared Tailwind styles
└── utils/helpers.ts
cdk/                            # AWS CDK infrastructure
scripts/mcp-proxy.ts            # Local dev: proxies MCP Inspector → Lambda
dist/mcp-lambda/                # Build output (bundled JS + HTML apps)

构建命令

npm run build                        # Full build: typecheck + apps + esbuild + CDK synth
npm run build:apps                   # Build all MCP App HTML bundles
npm run build:app:get-resume                   # Build resume app only
npm run build:app:get-architecture             # Build architecture app only
npm run build:app:get-archils-work-experience  # Build work experience app only
npm run typecheck                    # TypeScript type check (no emit)
npm run dev                          # Watch apps + start MCP proxy for local dev
npm run deploy                       # Deploy to AWS (prod)

部署

服务器使用Lambda Web适配器作为Node 24 AWS Lambda函数运行。MCP端点位于 /mcp （POST、流式HTTP传输）。

基础设施定义见 cdk/ 并使用AWS CDK进行部署。

相关 MCP