关键词

Terraform AWS ProviderGitHub IssuesGitHub ReleasesIaC

项目简介

这是一个基于 Model Context Protocol (MCP) 构建的服务器，专注于为大型语言模型 (LLM) 客户端提供与 Terraform AWS Provider 相关的上下文信息。它通过 MCP 协议暴露一系列工具和资源，使 LLM 能够获取 Terraform AWS Provider 在 GitHub 仓库中的公开信息，例如 issues (问题) 和 releases (版本发布)。

主要功能点

  • GitHub Issue 信息获取： LLM 可以调用工具来列出 Terraform AWS Provider GitHub 仓库的所有开放问题，或获取特定问题的详细信息。
  • GitHub Release 信息获取： LLM 可以调用工具来列出所有版本发布，或者获取最新版本或指定版本标签的详细信息（包括关联的 issue 信息）。
  • 提供关键资源链接： 提供指向 Terraform AWS Provider GitHub 仓库和官方注册表页面的资源链接。

安装步骤

此 MCP 服务器需要 Deno 运行时或 Docker 才能运行。

  1. 获取 GitHub Token： 您需要一个具有访问公共仓库权限的 GitHub 个人访问令牌 (Personal Access Token)。
  2. 设置环境变量： 将您的 GitHub Token 设置为环境变量，变量名可以是 'GITHUB_TOKEN'、'GH_TOKEN' 或 'GITHUB_PERSONAL_ACCESS_TOKEN' 中的任意一个。
  3. 启动服务器：
    • 使用 Deno (推荐): 打开终端，运行命令 'deno run -A jsr:@excoriate/mcp-terraform-aws-provider-docs@latest'。
    • 使用 Docker: 如果您已构建 Docker 镜像 (参考仓库 README)，运行命令 'docker run -it --rm -e GITHUB_TOKEN=<YOUR_TOKEN> mcp-terraform-aws-provider-docs' (请将 '<YOUR_TOKEN>' 替换为您的 GitHub Token)。

服务器启动后，会通过标准输入/输出 (stdio) 协议与 MCP 客户端通信。

服务器配置（用于 MCP 客户端）

要让您的 LLM 客户端（如 Cursor, Claude Desktop, Windsurf, VSCode 等支持 MCP 的客户端）使用此服务器，您需要在客户端的 MCP 配置中添加服务器条目。配置信息通常是 JSON 格式，您需要提供以下关键信息：

  • 服务器名称 (Server Name): 您为此服务器在客户端中设定的唯一标识符，例如 'tf_aws_provider_docs'。
  • 启动命令 (Command): 客户端用于启动此服务器进程的可执行文件路径，例如 'deno' 或 'docker'。
  • 启动参数 (Args): 一个字符串数组，包含传递给启动命令的参数。例如，使用 Deno 从 JSR 运行的参数可以是 '["run", "-A", "jsr:@excoriate/mcp-terraform-aws-provider-docs@latest"]'。使用 Docker 的参数可能需要指定镜像名称和环境变量 '-e GITHUB_TOKEN=<YOUR_TOKEN>'。
  • 环境变量 (Optional Env): 如果启动命令不方便直接传递 GitHub Token (例如某些 Docker 用法或客户端配置方式)，可以在这里设置 '{"GITHUB_TOKEN": "<YOUR_TOKEN>"}'。

请参考您的具体 MCP 客户端文档，了解如何在配置文件中添加并填写这些信息。

基本使用方法

一旦 MCP 服务器成功连接到您的 LLM 客户端，您的 LLM 就可以通过调用服务器提供的工具来获取信息。

例如，LLM 可以：

  • 调用 'get-open-issues' 工具来获取当前开放的问题列表。
  • 调用 'get-issue' 工具并提供一个问题编号来获取该问题的详细描述。
  • 调用 'get-latest-release' 工具来查看最新的版本发布信息。

LLM 客户端通常会提供一个界面或通过对话来让您指示 LLM 调用这些工具。

信息

分类

开发者工具

访问项目