Documentation

Servers

This guide provides information about available Model Context Protocol (MCP) servers, their capabilities, and how to set them up with Kiro.

Warning

Only add MCP servers from trusted sources, and review all applicable server licensing information and documentation. Kiro is not responsible for any third-party MCP servers or other packages.

Copied!AWS Documentation Server

The AWS Documentation server provides access to AWS documentation, search capabilities, and content recommendations.

Copied!Capabilities

  • Search AWS documentation across all services
  • Read documentation pages in markdown format
  • Get content recommendations related to specific documentation pages

Copied!Setup Instructions

Copied!Prerequisites

  1. Install uv from Astral:

    bash
    # On macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # On Windows PowerShell irm https://astral.sh/uv/install.ps1 | iex
  2. Install Python 3.10 or newer:

    bash
    uv python install 3.10

Copied!Configuration

For macOS/Linux:

json
{ "mcpServers": { "aws-docs": { "command": "uvx", "args": ["awslabs.aws-documentation-mcp-server@latest"], "env": { "FASTMCP_LOG_LEVEL": "ERROR" }, "disabled": false, "autoApprove": [] } } }

For Windows:

json
{ "mcpServers": { "aws-docs": { "command": "uv", "args": [ "tool", "run", "--from", "awslabs.aws-documentation-mcp-server@latest", "awslabs.aws-documentation-mcp-server.exe" ], "env": { "FASTMCP_LOG_LEVEL": "ERROR" } } } }

Copied!Available Tools

Tool NameDescription
mcp_aws_docs_search_documentationSearch AWS documentation for specific topics
mcp_aws_docs_read_documentationRead AWS documentation pages in markdown format
mcp_aws_docs_recommendGet content recommendations related to a documentation page

Copied!Usage Examples

# Search for information about S3 bucket policies Search AWS documentation for S3 bucket policies # Read specific documentation Read the AWS Lambda function URLs documentation # Get recommendations Find related content to AWS ECS task definitions

Copied!GitHub MCP Server

The GitHub MCP server allows Kiro to interact with GitHub repositories, issues, and pull requests.

Copied!Capabilities

  • Access repository information including files, commits, and branches
  • Create and manage issues and pull requests
  • Search repositories for specific content

Copied!Setup Instructions

Warning

The previously recommended @modelcontextprotocol/server-github package has been archived. GitHub now recommends using their official Docker-based MCP server.

Copied!Prerequisites

  1. Install Docker if not already installed:

  2. Create a GitHub Personal Access Token:

    • Go to GitHub Settings > Developer settings > Personal access tokens (fine-grained)
    • Generate a new token with permissions that fit the tools you need

Copied!Configuration

Follow these steps from the official GitHub documentation:

  1. Create a .kiro/settings/mcp.json file in your workspace directory (or edit if it already exists)
  2. Add this configuration:
json
{ "mcpServers": { "github": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here" }, "disabled": false, "autoApprove": [] } } }

For more detailed installation instructions, refer to the official GitHub MCP Server documentation.

Copied!Common Tools

The GitHub MCP server provides a comprehensive set of tools for interacting with GitHub. Here are some of the most commonly used tools organized by category:

Repository Tools
Tool NameDescription
search_repositoriesSearch for GitHub repositories
get_file_contentsGet the contents of a file from a repository
search_codeSearch for code in repositories
list_branchesList branches in a repository
create_branchCreate a new branch in a repository
Issue Tools
Tool NameDescription
list_issuesList issues in a repository
get_issueGet details of a specific issue
create_issueCreate a new issue in a repository
update_issueUpdate an existing issue
add_issue_commentAdd a comment to an issue
Pull Request Tools
Tool NameDescription
list_pull_requestsList pull requests in a repository
get_pull_requestGet details of a specific pull request
create_pull_requestCreate a new pull request
get_pull_request_filesGet files changed in a pull request
merge_pull_requestMerge a pull request
Actions and Workflows
Tool NameDescription
list_workflowsList workflows in a repository
list_workflow_runsList workflow runs for a specific workflow
get_workflow_runGet details of a specific workflow run
Code Security
Tool NameDescription
list_code_scanning_alertsList code scanning alerts in a repository
get_code_scanning_alertGet details of a specific code scanning alert
Dependabot
Tool NameDescription
list_dependabot_alertsList Dependabot alerts in a repository
get_dependabot_alertGet details of a specific Dependabot alert
Discussions
Tool NameDescription
list_discussionsList discussions in a repository
get_discussionGet details of a specific discussion
get_discussion_commentsGet comments from a discussion
Notifications
Tool NameDescription
list_notificationsList GitHub notifications
get_notification_detailsGet detailed information for a specific notification
mark_all_notifications_readMark all notifications as read

Copied!Available Toolsets

The GitHub MCP server organizes its functionality into toolsets that can be enabled or disabled as needed. By default, all toolsets are enabled. Here's an overview of the available toolsets:

ToolsetDescription
contextStrongly recommended: Tools that provide context about the current user and GitHub context you are operating in
actionsGitHub Actions workflows and CI/CD operations
code_securityCode security related tools, such as GitHub Code Scanning
dependabotDependabot tools
discussionsGitHub Discussions related tools
experimentsExperimental features that are not considered stable yet
issuesGitHub Issues related tools
notificationsGitHub Notifications related tools
orgsGitHub Organization related tools
pull_requestsGitHub Pull Request related tools
reposGitHub Repository related tools
secret_protectionSecret protection related tools, such as GitHub Secret Scanning
usersGitHub User related tools

Copied!Configuring Toolsets

You can specify which toolsets you want to enable when configuring the GitHub MCP server. This allows you to control which GitHub API capabilities are available to your AI tools.

Copied!Using Toolsets With Docker

When using Docker, you can pass the toolsets as environment variables:

bash
docker run -i --rm \ -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \ -e GITHUB_TOOLSETS="repos,issues,pull_requests,actions,code_security,experiments" \ ghcr.io/github/github-mcp-server

Copied!The "all" Toolset

The special toolset all can be provided to enable all available toolsets regardless of any other configuration:

bash
# Using command line argument ./github-mcp-server --toolsets all # Or using environment variable GITHUB_TOOLSETS="all" ./github-mcp-server

When using Docker with the "all" toolset:

bash
docker run -i --rm \ -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \ -e GITHUB_TOOLSETS="all" \ ghcr.io/github/github-mcp-server

Copied!Usage Examples

# Get repository information Show me information about the tensorflow/tensorflow repository # Search for code Find examples of React hooks in facebook/react # Create an issue Create an issue in my repository about the login bug

Copied!Web Search Server

The Web Search MCP server provides access to web search results using the Brave Search API.

Copied!Capabilities

  • Search the web for information
  • Get real-time information not available in Kiro's training data

Copied!Setup Instructions

Copied!Prerequisites

  1. Install Node.js and NPM if not already installed.

  2. Get a Brave Search API key:

Copied!Configuration

json
{ "mcpServers": { "web-search": { "command": "npx", "args": [ "-y", "@brave/brave-search-mcp-server", "--transport", "stdio" ], "env": { "BRAVE_API_KEY": "your-api-key" } }, } }

Copied!Available Tools

Tool NameDescription
brave_web_searchPerforms general web searches using Brave Search API
brave_local_searchSearches for local businesses and places using Brave's Local Search API
brave_video_searchSearches for videos using Brave's Video Search API
brave_image_searchPerforms image searches using Brave Search API
brave_news_searchSearches for current news articles using Brave's News Search API
brave_summarizerRetrieves AI-generated summaries of web search results using Brave's Summarizer API

Copied!Usage Examples

# Search for information Find the latest information about TypeScript 5.0 features # Search for news What are the latest developments in quantum computing?

Copied!Remote MCP Servers

Kiro currently supports local stdio MCP servers, however you can add remote MCP servers by leveraging the mcp-remote npm package to make requests to the remote MCP endpoint.

Copied!Setup Instructions

Copied!Prerequisites

  1. Install Node.js and NPM if not already installed.

Copied!Configuration

json
{ "mcpServers": { "my-remote-mcp": { "command": "npx", "args": [ "mcp-remote", "https://<remote-mcp-endpoint>", "--transport", "sse" ], "disabled": false } } }

Copied!Custom MCP Servers

You can create your own MCP servers to extend Kiro's capabilities for your specific needs.

Copied!Creating a Custom Server

  1. Choose a programming language (Python, Node.js, etc.)
  2. Implement the MCP protocol using available libraries
  3. Define your tools and their capabilities
  4. Package and distribute your server

Copied!Resources for Custom Server Development

Copied!Additional MCP Servers

Copied!Database Servers

  • PostgreSQL MCP Server: Query and manage PostgreSQL databases
  • MongoDB MCP Server: Interact with MongoDB databases

Copied!Development Tools

  • Docker MCP Server: Manage Docker containers and images
  • Kubernetes MCP Server: Interact with Kubernetes clusters

Copied!Cloud Providers

  • Azure MCP Server: Interact with Azure services and resources
  • GCP MCP Server: Manage Google Cloud Platform resources

Copied!Finding More MCP Servers

To discover additional MCP servers:

  1. Visit the MCP Registry
  2. Check the GitHub MCP Organization
  3. Search for mcp-server on npm or PyPI

For information on configuring MCP servers, see the MCP Configuration page.

Page updated: July 25, 2025