Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:mcp-builder

Xây MCP server có ích

Dựng, nâng cấp, test và publish MCP server đưa dịch vụ bên ngoài thành tool, nhắm protocol 2026-07-28 với TypeScript SDK v2 hoặc Python mcp v2 (MCPServer).

Bắt đầu từ tác vụ

Kiểm stack hiện có

Chọn transport

Làm trọn một tool

Nguyên tắc 01

Chốt tác vụ và contract tool đầu tiên trước khi chọn hạ tầng

Nguyên tắc 02

Annotation chỉ là gợi ý, không phải cơ chế bảo vệ; kiểm quyền mọi thao tác phía server

Nguyên tắc 03

Một tool chạy trọn và đã xác minh tốt hơn nhiều tool chỉ đăng ký

Nguyên tắc 04

Đăng ký tool chưa phải là xong; báo đúng những gì client thật quan sát được

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

Khởi động

Đầu vào, phạm vi, route

1 Bắt đầu từ tác vụ Xác định tác vụ của người dùng và contract của tool đầu tiên (input, dạng output, tác dụng phụ, auth) trước khi chọn hạ tầng.
2 Kiểm stack hiện có Kiểm ngôn ngữ, phiên bản SDK và transport của project. Chỉ nâng SDK v1 khi được yêu cầu hoặc khi tính năng cần thiết bắt buộc; đọc tài liệu protocol khi gặp tính năng đã deprecated (sampling, roots, logging, SSE).

Xử lý

Agent / skill thực thi

3 Chọn transport Mặc định dùng stdio cho server local một người dùng và Streamable HTTP cho server từ xa hoặc nhiều người dùng. Không bao giờ dựng server mới trên transport HTTP+SSE đã deprecated.
4 Làm trọn một tool Làm một luồng chạy được từ input đã validate, qua lời gọi upstream có kiểm quyền, tới output có cấu trúc và giới hạn: input schema có ràng buộc, outputSchema kèm structuredContent, annotation chính xác, kết quả isError chỉ rõ cách xử lý, timeout và phân trang.

Kiểm chứng

Gate, review, xác thực

5 Kiểm quyền và xác nhận Kiểm quyền mọi thao tác phía server. Xác nhận thao tác phá huỷ qua elicitation; với client không hỏi được người dùng thì từ chối cho tới khi có tham số xác nhận rõ ràng. Giữ credential trong biến môi trường hoặc OAuth token đã validate và không bao giờ chuyển token của client lên upstream.
6 Xác minh bằng client thật Kiểm type hoặc import, rồi chạy server bằng MCP Inspector CLI hoặc client SDK: lời gọi hợp lệ, input sai, lỗi upstream, phân trang, và với HTTP thì 401/403/Origin. Dùng tiến trình có giới hạn do harness quản lý và dừng những tiến trình đã khởi động.

Đóng

Báo cáo, bàn giao, artifact

7 Đánh giá chất lượng tác vụ Viết câu hỏi evaluation chỉ đọc và chạy scripts/evaluation.py; chỉ thêm tool khi workflow được yêu cầu cần tới và chạy lại check sau mỗi thay đổi.
8 Báo cáo, publish khi được yêu cầu Báo tool chạy được, kết quả quan sát từ client và năng lực còn thiếu hoặc chưa xác minh; đăng ký tool chưa phải là xong. Chỉ publish server.json lên MCP Registry khi người dùng yêu cầu.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:mcp-builder [service or API to integrate]

Đối số

[service or API to integrate] Bắt buộc

Integration đích

Dịch vụ hoặc API bên ngoài cần biến thành MCP server mới hoặc mở rộng bề mặt tool/resource. Nêu workflow dự kiến, ngôn ngữ, transport, auth, quyền, rate limit, khối lượng dữ liệu và tác động ngoài được phép nếu đã biết.

/ak:mcp-builder "Build một TypeScript MCP server cho Acme tickets API với search chỉ-đọc trước, cursor pagination, và stdio transport"

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Server API mặc định Khuyến nghị

/ak:mcp-builder API triage issue Linear

Dùng khi:: Dùng khi xây MCP server hoặc tool surface cho một dịch vụ bên ngoài.
Kết quả:: Chốt tác vụ triage và contract tool đầu tiên, làm trọn một tool có output cấu trúc và annotation, chạy thử bằng MCP Inspector, rồi thêm các tool mà workflow cần.

Server Python MCPServer

/ak:mcp-builder server Python mcp v2 tìm kiếm khách hàng qua stdio

Dùng khi:: Dùng khi server nên viết bằng Python với SDK mcp v2.
Kết quả:: Dùng tài liệu server Python với MCPServer, định nghĩa input có ràng buộc và outputSchema, giữ credential trong biến môi trường, và kiểm các lời gọi hợp lệ, input sai và lỗi upstream.

Server TypeScript từ xa

/ak:mcp-builder server TypeScript cho quy trình quản trị billing qua Streamable HTTP có OAuth

Dùng khi:: Dùng khi project cần server từ xa nhiều người dùng trên @modelcontextprotocol/server v2.
Kết quả:: Dựng trên Streamable HTTP, validate OAuth token dành cho server này, xác nhận thao tác billing phá huỷ qua elicitation, và test xử lý 401, 403 và Origin.

Nâng cấp server v1

/ak:mcp-builder chuyển server SSE v1 của chúng tôi sang protocol 2026-07-28

Dùng khi:: Dùng khi server đang có dựa vào SDK v1 hoặc tính năng deprecated như SSE, sampling, roots hay logging.
Kết quả:: Đọc tài liệu chuyển đổi protocol, bỏ transport HTTP+SSE, nâng SDK, và chạy lại kiểm tra bằng Inspector cùng evaluation để chứng minh tool vẫn hoạt động như cũ.

Phạm vi xử lý

MCP spec 2026-07-28
Server TypeScript SDK v2 và Python mcp v2
Thiết kế tool, schema và annotation
Auth HTTP và OAuth
Kiểm bằng Inspector và evaluation
Publish lên MCP Registry

Artifact tạo ra

Sản phẩm MCP

Mẫu đường dẫn

Code server + schema tool + kết quả từ client + evaluation

Các tool chạy được, kết quả quan sát từ Inspector hoặc client SDK, kết quả evaluation và năng lực còn thiếu hoặc chưa xác minh; chỉ có mục trên registry khi được yêu cầu publish.