Strands Agents MCP Server

---

この MCP サーバーは、llms.txt ファイルを通じて GenAI ツールから厳選されたドキュメントにアクセスできるようにし、AI コーディングアシスタントが関連ドキュメントをインテリジェントなランキングで検索・取得できるようにします。

特長

• スマートなドキュメント検索：Markdown を考慮したスコアリングによる TF-IDF ベースの検索で、タイトル、見出し、コードブロックを優先します
• セクション単位の閲覧：目次からドキュメント構造を確認し、必要なセクションだけを取得できます。ページ全体を取得するよりもトークン効率に優れています
• 厳選されたコンテンツ：読みやすく明瞭なタイトルとともに、llms.txt ファイルからドキュメントをインデックス化します
• オンデマンド取得：パフォーマンスを最適化するため、必要なときにのみドキュメント全体を遅延読み込みします
• スニペット生成：関連性スコア付きの文脈に即したスニペットを提供し、すばやく概要を把握できます
• 実 URL 対応：後方互換性を維持しながら、実際の HTTPS URL を利用できます

前提条件

以下の使用方法では、システムに uv がインストールされている必要があります。公式のインストール手順に従ってインストールできます。

インストール

Strands Agents MCP サーバーは、Amazon Q Developer CLI、Anthropic Claude Code、Cline、Cursor など、 MCP サーバーに対応した40以上のアプリケーションで使用できます。

人気の MCP クライアント向けのワンクリックインストールボタンを使って、すぐに使い始められます。以下のボタンをクリックして、IDE にサーバーを直接インストールしてください。

Kiro の例

MCP 設定の管理方法については、Kiro のドキュメントを参照してください。

~/.kiro/settings/mcp.json に記述します。

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

Q Developer CLI の例

MCP 設定の管理方法については、Q Developer CLI のドキュメントを参照してください。

~/.aws/amazonq/mcp.json に記述します。

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

Claude Code の例

MCP サーバーの管理方法については、Claude Code のドキュメントを参照してください。

claude mcp add strands uvx strands-agents-mcp-server

Cline の例

MCP 設定の管理方法については、Cline のドキュメントを参照してください。

以下の情報を Cline に入力してください。

I want to add the MCP server for Strands Agents.
Here's the GitHub link: @https://github.com/strands-agents/mcp-server
Can you add it?"

Cursor の例

MCP 設定の管理方法については、Cursor のドキュメントを参照してください。

~/.cursor/mcp.json に記述します。

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

VS Code の例

MCP 設定の管理方法については、VS Code のドキュメントを参照してください。

mcp.json ファイルに記述します。

{
  "servers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"]
    }
  }
}

クイックテスト

MCP Inspector を使って、MCP サーバーをすばやくテストできます。

# For published package
npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server

# For local development
npx @modelcontextprotocol/inspector python -m strands_mcp_server

注：システムに npx がインストールされている必要があります。これは Node.js に同梱されています。

Inspector は、接続とプロトコルに関する詳細情報を確認できるため、MCP サーバーの問題のトラブルシューティングにも役立ちます。詳しいガイドについては、MCP Inspector のドキュメントをご覧ください。

はじめに

1. 前提条件をインストールします：

   • uv を公式のインストール手順に従ってインストールします
   • npx コマンドを使用するため、Node.js がインストールされていることを確認します

2. MCP クライアントを設定します：

   • 上記のインストール例から、使用する MCP クライアントを選択します
   • Strands Agents MCP サーバーの設定をクライアントに追加します

3. 接続をテストします：

   # For published package
   npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server
   
   # For local development
   npx @modelcontextprotocol/inspector python -m strands_mcp_server
   

4. ドキュメントツールを使い始めます：

   • search_docs - 関連するドキュメントを、インテリジェントなランキングで検索します
   • fetch_doc - ページの構成と導入部分を確認してから、個々のセクションを読み込みます
   • サーバーは llms.txt ファイルから厳選されたコンテンツを自動的にインデックス化します

サーバーの開発

git clone https://github.com/strands-agents/mcp-server.git
cd mcp-server
python3 -m venv venv
source venv/bin/activate
pip3 install -e ".[dev]"

npx @modelcontextprotocol/inspector python -m strands_mcp_server

テストの実行

# Unit tests (fast, no network access required)
pytest tests/

# Integration tests (requires network access to strandsagents.com)
pytest tests_integ/ -v

# All tests
pytest tests/ tests_integ/ -v

統合テストをスキップするには（例：ネットワークにアクセスできない CI 環境の場合）：

SKIP_INTEG_TESTS=1 pytest tests_integ/

コントリビューション ❤️

コントリビューションを歓迎します！詳細については、コントリビューションガイドをご覧ください。

• バグや機能の報告
• 開発環境のセットアップ
• プルリクエストによるコントリビューション
• 行動規範
• セキュリティ問題の報告

チームと交流する

DiscordでStrandsチームやほかのユーザーと交流しましょう。

ライセンス

このプロジェクトはApache License 2.0のもとでライセンスされています。詳細については、LICENSEファイルをご覧ください。

セキュリティ

詳細については、CONTRIBUTINGをご覧ください。