关键词

TypeSpec开发工具AI Agent后端开发语言模型集成

项目简介

'typespec-mcp' 仓库是一个包含用于构建 Model Context Protocol (MCP) 服务器的工具集和核心组件的项目。其中包含的 TypeSpec MCP Server 是一个专门为开发者设计的 MCP 服务器实例，其主要功能不是提供最终用户数据或服务，而是辅助开发者使用 TypeSpec 语言来定义、生成和管理自己的 MCP 服务器和工具。它本身也是一个 MCP 服务器，通过提供一组开发相关的工具与支持 MCP 协议的客户端（如 VS Code 的 AI Agent）进行交互。

主要功能点

该开发服务器提供的核心功能围绕 TypeSpec 和 MCP 项目的开发流程：

  • 学习 TypeSpec: 提供关于如何理解和编写 TypeSpec 代码的帮助信息，特别是针对 MCP 相关的部分。
  • 项目初始化: 在指定目录下快速生成一个新的 TypeSpec 项目骨架，包含 MCP 开发所需的示例和配置。
  • 代码编译: 调用 TypeSpec 编译器对项目中的 '.tsp' 文件进行编译，生成代码和其他资产。
  • 项目构建: 执行项目中的构建命令（通常是 'npm run build'），完成最终构建流程。

安装步骤

该服务器需要 Node.js 环境。请确保已安装 Node.js 20 或更高版本。

  1. 安装 Visual Studio Code 或 VS Code Insiders。

  2. 在 VS Code 中安装 GitHub Copilot 和 GitHub Copilot Chat 扩展。

  3. 安装 TypeSpec VS Code 扩展。

  4. 在 VS Code 中打开一个空文件夹或您的项目文件夹。

  5. 使用以下命令通过 npx 安装并运行 TypeSpec MCP Server：

    npx -y mcp-server-typespec@latest

    通常，这个命令不会直接在终端中运行，而是通过 MCP 客户端（如 VS Code Copilot Agent）来启动。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令和参数才能连接。TypeSpec MCP Server 通常通过 Stdio 协议与客户端通信。以下是在 VS Code 中配置 TypeSpec MCP Server 的示例 '.vscode/mcp.json' 文件内容（请在您的项目中创建此文件）：

{
  "servers": {
    "TypeSpec MCP Server": {
      // 指定启动服务器的可执行文件或命令
      "command": "npx",
      // 指定传递给命令的参数列表
      "args": [
        // -y 参数用于自动确认安装 mcp-server-typespec 包
        "-y",
        // 指定要运行的 TypeSpec MCP Server 包及其版本
        "mcp-server-typespec@latest"
      ]
    }
  }
}

基本使用方法

配置完成后，您可以在支持 MCP 的客户端中使用该服务器。例如，在 VS Code 的 GitHub Copilot Chat 界面中，切换到 Agent 模式，并确保 TypeSpec MCP Server 已被识别并选中为可用工具。

然后，您可以在聊天界面中尝试使用服务器提供的工具，例如：

  • 询问关于 TypeSpec MCP 开发的信息（服务器可能会利用 'learnTypeSpec' 工具）。
  • 使用 'init' 命令在当前工作区初始化一个新的 TypeSpec MCP 项目。
  • 使用 'compile' 命令编译您项目中的 '.tsp' 文件。
  • 使用 'build' 命令构建您的 MCP 项目。

请参考客户端的具体使用说明来了解如何与 MCP 服务器的工具进行交互。

信息

分类

开发者工具

访问项目