beginner⏱️ 10-20 minutes📅 Updated June 2026

Step-by-step guide to integrate use_aws_mcp MCP server with MCPHub (mcp.nvim). Enhanced MCPHub (mcp.nvim) functionality with use_aws_mcp integration.

use_aws_mcp + MCPHub (mcp.nvim): Complete MCP Integration

use_aws_mcp is a MCP server that amazon-q-cli's use_aws tool extracted into independent mcp, for general aws api usage..

When integrated with MCPHub (mcp.nvim), you can:

  • Access use_aws_mcp functionality through MCPHub (mcp.nvim)

This guide provides step-by-step instructions to set up use_aws_mcp in MCPHub (mcp.nvim), including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

  • use_aws_mcp will be fully integrated and operational
  • You can use use_aws_mcp tools directly in MCPHub (mcp.nvim)
  • All use_aws_mcp capabilities will be available for your workflows

Prerequisites

Before starting, ensure you have:

  • MCPHub (mcp.nvim) installed and configured
  • Compatible operating system (Neovim 0.9+, Windows, macOS, Linux)

Installation

Step 1: Install use_aws_mcp

Configuration

Step 2: Configure MCPHub (mcp.nvim)

  1. Open MCPHub (mcp.nvim) settings
  2. Navigate to MCP server configuration
  3. Add use_aws_mcp server with appropriate settings
  4. Save and restart if needed

Examples

Once configured, you can use use_aws_mcp in MCPHub (mcp.nvim):

Testing Your Setup

  1. Launch MCPHub (mcp.nvim)
  2. Verify use_aws_mcp is available in the tools list
  3. Test basic use_aws_mcp functionality

Troubleshooting

Common Issues

Plugin Not Loading or Command Not Found

Symptoms: :MCPHub command not recognized, Plugin not appearing in :PlugStatus, No errors but plugin inactive

Cause: Plugin not properly installed or configuration error

Solution:

  • Verify plugin is added to plugin manager configuration
  • Run plugin manager install command (:PackerInstall, :PlugInstall, or Lazy auto-install)
  • Check for errors in :messages after sourcing config
  • Ensure dependencies (plenary.nvim, nui.nvim) are installed
  • Restart Neovim completely

MCP Server Won't Start

Symptoms: Server status shows "Error", Red indicator on server, Server immediately stops after starting

Cause: Invalid server configuration or missing dependencies

Solution:

  • Verify npx is installed and in PATH: npx --version
  • Check MCP server package exists: npx -y @modelcontextprotocol/server-filesystem --help
  • Review server configuration in setup() - verify command and args
  • Check server logs in MCPHub interface for detailed error messages
  • Ensure required environment variables are set (e.g., GITHUB_TOKEN)
  • Test server manually in terminal: npx -y @modelcontextprotocol/server-filesystem /path

UI Not Displaying Correctly

Symptoms: Blank window, Garbled text, Layout issues, Missing borders

Cause: Terminal or Neovim rendering issues

Solution:

  • Verify Neovim version is 0.9 or higher: nvim --version
  • Try different border style in ui.border config ("single", "double", "rounded")
  • Check terminal supports Unicode and 256 colors
  • Update nui.nvim dependency to latest version
  • Test with different colorscheme to rule out theme conflicts

Integration with Avante/CodeCompanion Not Working

Symptoms: AI assistant not seeing MCP tools, Tool calls failing, Integration not recognized

Cause: Integration not enabled or incompatible versions

Solution:

  • Verify integration is enabled in config: integrations.avante = true
  • Ensure Avante.nvim/CodeCompanion.nvim is installed and loaded
  • Check versions are compatible - update both plugins to latest
  • Restart Neovim after enabling integration
  • Check :checkhealth for integration-specific warnings

Marketplace Not Loading

Symptoms: :MCPHubMarketplace shows empty list, Network error in marketplace, Timeout loading servers

Cause: Network connectivity issues or marketplace service unavailable

Solution:

  • Verify internet connectivity
  • Check firewall allows HTTPS connections
  • Try again later if marketplace service is temporarily down
  • Review proxy settings if behind corporate firewall
  • Check :messages for detailed network error messages

Project-Local Config Not Loading

Symptoms: .mcphub.json ignored, Project servers not appearing, Only global config loaded

Cause: Config file location or format issues

Solution:

  • Verify .mcphub.json is in project root (same directory as .git)
  • Check JSON syntax is valid using jsonlint or similar tool
  • Ensure file name is exactly .mcphub.json (case-sensitive)
  • Restart Neovim after creating/modifying project config
  • Check file permissions are readable

use_aws_mcp not appearing in MCPHub (mcp.nvim)

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

  • Verify configuration syntax
  • Check use_aws_mcp installation
  • Restart MCPHub (mcp.nvim)
  • Check logs for error messages

Next Steps

Now that use_aws_mcp is integrated with MCPHub (mcp.nvim):

  • Explore all use_aws_mcp capabilities through MCPHub (mcp.nvim)
  • Check out other MCP servers that work with MCPHub (mcp.nvim)
  • Join the MCP community for tips and support
  • Consider contributing to use_aws_mcp development

Need Help?

Related Resources

More Integrations

Explore other MCP servers that work with MCPHub (mcp.nvim)

Need Help?

Join the MCP community for support and discussions

use_aws_mcp + MCPHub (mcp.nvim): MCP Setup Guide (2026)