TypeSpec MCP 服务器

TypeSpec MCP 服务器实现了 MCP 规范,帮助开发者快速构建基于 TypeSpec 的 MCP 服务器,并支持生成 REST API 和其他协议。

  • by microsoft
  • TypeScript
  • 本地部署
  • 50 星标
  • 更新于
在 GitHub 查看 microsoft/typespec-mcp

使用说明

TypeSpec MCP服务器和发射器

TypeSpec MCP服务器实现了 MCP规范 使您能够快速构建自己的MCP服务器 类型规格。我们还将使您能够构建REST API和TypeSpec支持的其他协议,尽管这项工作仍在进行中。

请注意,此项目处于公开预览阶段,在我们正式发布之前,实施可能会发生重大变化。

概述

此存储库中有哪些包?

目前,此仓库包含以下包:

当前支持的工具

TypeSpec MCP服务器提供以下工具:

  • learnTypeSpec -使用有关如何理解和编写TypeSpec的信息初始化模型。
  • init -使用示例工具实现在当前工作目录中构建一个新项目。
  • compile -运行tsp编译以生成发射器资源
  • build -执行 npm run build 在当前项目中。

入门指南

TypeSpec MCP服务器需要Node.js来安装和运行服务器。如果您没有安装它,请按照说明进行操作 这里.

VS代码+GitHub副本

TypeSpec MCP服务器协助编写TypeSpec以生成MCP资源实现。它可以单独使用或与 TypeSpec VS代码扩展名 在VS代码中。

先决条件

  1. 安装VS Code的稳定版或Insiders版:
  2. 安装 GitHub Copilot 和 GitHub Copilot 聊天助手 扩展
  3. 安装 Node.js 20或更晚
    • 确保 node 和 npm 在你的路上
  4. 在空文件夹中打开VS Code

安装

一键安装

单击其中一个按钮为VS Code或VS Code Insiders安装TypeSpec MCP服务器。

安装TypeSpec MCP服务器后,请确保选择GitHub Copilot代理模式并刷新工具列表。要了解有关代理模式的更多信息,请访问 VS代码文档.

手动安装

对于分步安装,请按照以下说明进行操作:

  1. 添加 .vscode/mcp.json:
{
  "servers": {
    "TypeSpec MCP Server": {
      "command": "npx",
      "args": ["-y", "mcp-server-typespec@latest"]
    }
  }
}

测试TypeSpec MCP服务器

  1. 在VS Code中打开GitHub Copilot 切换到代理模式
  2. 您应该在工具列表中看到TypeCpec MCP服务器
  3. 尝试告诉代理使用TypeSpecMCP服务器的提示,例如“init”来构建新项目。

故障排除

看 故障排除指南 有关常见问题和日志记录的帮助。

贡献

我们欢迎对TypeSpec MCP服务器的贡献!无论您是在修复错误、添加新功能还是改进文档,我们都欢迎您的贡献。

请阅读我们的 贡献指南 了解更多关于如何做出贡献的信息。

行为准则

该项目采用了 微软开源行为准则. 有关更多信息,请参阅 行为准则常见问题 或联系 opencode@microsoft.com 如有任何其他问题或意见。