使用说明
mcp-server-template 翻译为中文是“MCP服务器模板”
用于创建WebAssembly组件的模板仓库 模型上下文协议（MCP） 服务器， 和；带有；与……一起 wasmCloud。
依赖项
- 下载
wash
快速入门
克隆此仓库或使用 wash 创建一个使用此仓库作为模板的新项目：
wash new mcpserver --git https://github.com/cosmonic-labs/mcp-server-template-ts.git
cd mcpserver
启动开发循环
构建组件：
npm install
npm run dev
为了调试您的组件，我们建议使用 官方MCP模型检查器， 要运行它，你可以运行：
npm run inspector
使用模型检查器，您可以通过HTTP连接到本地MCP服务器，管理资源、运行工具等。
可选：使用（某工具/方法）生成MCP工具 openapi2mcp 插件
该 openapi2mcp 插件 for wash 使您能够根据OpenAPI规范生成MCP工具。
安装插件：
wash plugin install ghcr.io/cosmonic-labs/openapi2mcp:v0.5.0
根据OpenAPI规范在服务器项目中生成MCP工具：
wash openapi2mcp [path/to/open/yaml/or/json] --project-path [path/to/generated/mcp/server]
建立Cosmonic控制（或“Cosmonic管控体系”，具体翻译取决于“Cosmonic”的具体含义和上下文，此处提供一个较为通用的翻译）
一旦您的MCP服务器准备好投入实际使用，请确保您的 “Cosmonic”可以翻译为“宇宙的”或“与宇宙相关的”。这个词汇结合了“cosmo-”（意为宇宙）和“-nic”（可能是一个表示属性或特征的后缀，但在此上下文中，主要强调“宇宙”的概念），用于描述与宇宙有关的事物或特性 集群正在运行。
Don't have a Comsonic cluster set up?
:::warning[需要Cosmonic控制] 您需要一个Kubernetes集群以及Cosmonic Control的安装来部署该组件。请注册Cosmonic Control的 免费试用 并遵循 开始 Cosmonic Control 文档中的说明。 :::
要求：
安装本地Kubernetes环境
为了获得最佳的本地Kubernetes开发体验，我们建议安装 kind 以下（的） kind-config.yaml 配置：
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
# One control plane node and three "workers."
nodes:
- role: control-plane
extraPortMappings:
- containerPort: 30950
hostPort: 80
protocol: TCP
这将有助于实现使用Envoy的简单本地入口。
启动集群：
kind create cluster --config=kind-config.yaml
安装Cosmonic Control
:::warning[需要许可证密钥] 你需要一个 试用许可证密钥 按照这些说明操作。注册Cosmonic Control的 免费试用 拿到钥匙。 :::
使用 Helm 在 Kubernetes 上部署 Cosmonic Control：
helm install cosmonic-control oci://ghcr.io/cosmonic/cosmonic-control\
--version 0.3.0\
--namespace cosmonic-system\
--create-namespace\
--set envoy.service.type=NodePort\
--set envoy.service.httpNodePort=30950\
--set cosmonicLicenseKey="<insert license here>"
部署一个主机组：
helm install hostgroup oci://ghcr.io/cosmonic/cosmonic-control-hostgroup --version 0.3.0 --namespace cosmonic-system
使用 Helm CLI 部署应用程序
请确保在以下命令中替换为您自己的推送镜像：
helm install cosmonic-control oci://ghcr.io/cosmonic-labs/charts/http-trigger\
--version 0.1.2\
--set components.name=mcpserver\
--set components.image=ghcr.io/cosmonic-labs/petstore-mcp-server:v0.2.0\
--set ingress.host="mcpserver.localhost.cosmonic.sh"\
--set pathNote="/v1/mcp"
连接到已部署的MCP服务器
你可以使用 官方MCP模型检查员 进行连接。通过以下命令启动MCP检查器：
npx @modelcontextprotocol/inspector
