Smithy MCP Server

Overview

This MCP server provides semantic search and document access for Smithy documentation using AWS Bedrock Knowledge Bases. It enables AI assistants to answer questions about Smithy with accurate, context-aware responses.

MCP Endpoint

POST /mcp

All MCP requests should be sent to this endpoint using JSON-RPC 2.0 format.

Available Tools

search_smithy_docs

Search Smithy documentation using semantic search powered by Bedrock Knowledge Base.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_smithy_docs",
    "arguments": {
      "query": "How do I define a service?",
      "max_results": 5
    }
  },
  "id": 1
}

Parameters:

query (string, required): Search query
max_results (number, optional): Maximum results to return (1-10, default: 5)

read_smithy_doc

Read the full content of a specific Smithy documentation file.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "read_smithy_doc",
    "arguments": {
      "file_path": "quickstart.md"
    }
  },
  "id": 2
}

Parameters:

file_path (string, required): Relative path to the documentation file

list_smithy_topics

List all available Smithy documentation files.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_smithy_topics",
    "arguments": {}
  },
  "id": 3
}

Kiro IDE Integration

Add this server to your Kiro MCP configuration at .kiro/settings/mcp.json:

{
  "mcpServers": {
    "smithy": {
      "url": "https://smithymcp.com/mcp"
    }
  }
}

Note: Reconnect the MCP server from the Kiro MCP Server view after updating the configuration.

Claude Desktop Integration

Add this server to your Claude Desktop configuration:

{
  "mcpServers": {
    "smithy-docs": {
      "url": "https://your-domain.com/mcp",
      "transport": "http"
    }
  }
}

Configuration file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Note: Restart Claude Desktop after updating the configuration.

Example Usage

Once configured, you can ask Claude questions like:

"Search the Smithy docs for service definitions"
"How do I use Smithy traits?"
"Show me Smithy model examples"
"What are the best practices for Smithy API design?"

Architecture

This server uses:

AWS Lambda: Serverless compute for MCP server
Bedrock Knowledge Base: Semantic search with S3 vector storage
CloudFront: Global CDN for low-latency access
S3: Documentation storage and vector embeddings