エンジニアのためのMCP勉強会#1『MCPを活用した検索システムの作り方』というテーマで登壇しました #catalks

$ curl -LsSf https://astral.sh/uv/install.sh | sh
$ which uvx
/Users/ユーザー名/.local/bin/uvx

{
    "mcpServers": {
      "awslabs.aws-documentation-mcp-server": {
          "command": "/Users/ユーザー名/.local/bin/uvx",
          "args": ["awslabs.aws-documentation-mcp-server@latest"],
          "env": {
            "FASTMCP_LOG_LEVEL": "ERROR"
          },
          "disabled": false,
          "autoApprove": []
      }
    }
}

$ curl -X POST https://proxy.search.docs.aws.amazon.com/search \
  -H "Content-Type: application/json" \
  -d '{
    "textQuery": {
      "input": "S3 bucket naming rules"
    },
    "contextAttributes": [
      {
        "key": "domain",
        "value": "docs.aws.amazon.com"
      }
    ],
    "acceptSuggestionBody": "RawText",
    "locales": ["en_us"]
  }'

{
  "queryId": "40dd0cc1-4e0f-42af-9385-a1878fe3cbb5",
  "suggestions": [
    {
      "textExcerptSuggestion": {
        "link": "https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-naming.html",
        "title": "Amazon S3 table bucket, table, and namespace naming rules - Amazon Simple Storage Service",
        "suggestionBody": "For general purpose bucket naming rules, see General purpose bucket naming rules. For directory bucket naming rules, see Directory bucket naming rules.",
        "summary": "Use the table bucket naming rules to create table buckets and name tables and namespaces in Amazon S3 Tables.",
        "context": [
          {
            "key": "aws-docs-search-product",
            "value": "Amazon Simple Storage Service"
          },
          {
            "key": "domain",
            "value": "docs.aws.amazon.com"
          },
          {
            "key": "document-type",
            "value": "documentation"
          },
          {
            "key": "publisher",
            "value": "aws"
          },
          {
            "key": "aws-docs-search-guide",
            "value": "User Guide"
          },
          {
            "key": "programming-language",
            "value": "javascript"
          }
        ],
        "sourceUpdatedAt": 1741901134584,
        "isCitable": true
      }
    },
    {
      "textExcerptSuggestion": {
        "link": "https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html",
        "title": "Directory bucket naming rules - Amazon Simple Storage Service",
        "suggestionBody": "When you create a directory bucket in Amazon S3, the following bucket naming rules apply. For general purpose bucket naming rules, see General purpose bucket naming rules.",
        "summary": "Use the directory bucket naming rules when you create a directory bucket in Amazon S3.",
        "context": [
          {
            "key": "domain",
            "value": "docs.aws.amazon.com"
          },
          {
            "key": "programming-language",
            "value": "javascript"
          },
          {
            "key": "document-type",
            "value": "documentation"
          },
          {
            "key": "publisher",
            "value": "aws"
          },
          {
            "key": "aws-docs-search-guide",
            "value": "User Guide"
          },
          {
            "key": "aws-docs-search-product",
            "value": "Amazon Simple Storage Service"
          }
        ],
        "sourceUpdatedAt": 1743438752030,
        "isCitable": true
      }
    },
...
  ],
  "facets": {
    "aws-docs-search-guide": [
      "User Guide",
      "API Reference",
      "Developer Guide",
      "Defining S3 bucket and path names for data lake layers on the AWS Cloud",
      "Guide",
      "Implementation Guide",
      "Administration Guide",
      "Amazon GuardDuty User Guide",
      "Amazon QuickSight",
      "Controls Reference Guide"
    ],
    "aws-docs-search-product": [
      "Amazon Simple Storage Service",
      "AWS CloudFormation",
      "AWS Prescriptive Guidance",
      "AWS Config",
      "AWS SDK For Ruby V3",
      "AWS Cloud Development Kit (AWS CDK)",
      "Amazon S3 on Outposts",
      "AWS CLI",
      "AWS SimSpace Weaver",
      "Amazon Bedrock"
    ]
  }
}

@mcp.tool()
async def search_documentation(...) -> List[SearchResult]:
…
   request_body = {
        'textQuery': {
            'input': search_phrase,
        },
        'contextAttributes': [{'key': 'domain', 'value': 'docs.aws.amazon.com'}],
        'acceptSuggestionBody': 'RawText',
        'locales': ['en_us'],
    }
   async with httpx.AsyncClient() as client:
        try:
            response = await client.post(
                SEARCH_API_URL,
                json=request_body,
                headers={'Content-Type': 'application/json', 'User-Agent': DEFAULT_USER_AGENT},
                timeout=30,
            )

def extract_content_from_html(html: str) -> str:
    …
    try:
        # First use BeautifulSoup to clean up the HTML
        from bs4 import BeautifulSoup
        # Parse HTML with BeautifulSoup
        soup = BeautifulSoup(html, 'html.parser')
        …
    # Use markdownify on the cleaned HTML content
    content = markdownify.markdownify(
        str(main_content),
    …
    )
    …
    return content