이 MCP (Model Context Protocol) 서버는 llms.txt 파일을 통해 GenAI (생성형 AI) 도구에 대한 큐레이션된 문서 접근을 제공하며, AI 코딩 어시스턴트가 지능적인 랭킹을 통해 관련 문서를 검색하고 검색할 수 있도록 지원합니다.

스마트 문서 검색 (Smart Document Search): 제목, 헤더 및 코드 블록에 우선순위를 두는 Markdown 인식 스코어링이 적용된 TF-IDF 기반 검색
섹션 기반 브라우징 (Section-Based Browsing): 목차를 통해 문서 구조를 탐색한 후 필요한 섹션만 가져옵니다. 전체 페이지를 가져오는 것보다 토큰 효율적입니다.
큐레이션된 콘텐츠 (Curated Content): 깨끗하고 사람이 읽기 쉬운 제목과 함께 llms.txt 파일의 문서를 인덱싱합니다.
온디맨드 페칭 (On-Demand Fetching): 최적의 성능을 위해 필요한 경우에만 전체 문서 콘텐츠를 지연 로딩 (Lazy-loading) 합니다.
스니펫 생성 (Snippet Generation): 빠른 개요 파악을 위해 관련성 점수가 포함된 문맥적 스니펫 (Snippet)을 제공합니다.
실제 URL 지원 (Real URL Support): 하위 호환성을 유지하면서 실제 HTTPS URL과 함께 작동합니다.

아래의 사용 방법은 시스템에 uv가 설치되어 있어야 합니다. 공식 설치 지침을 따라 설치할 수 있습니다.

Amazon Q Developer CLI, Anthropic Claude Code, Cline, Cursor를 포함하여 MCP 서버를 지원하는 40개 이상의 애플리케이션에서 Strands Agents MCP 서버를 사용할 수 있습니다.

인기 있는 MCP 클라이언트를 위한 원클릭 설치 버튼으로 빠르게 시작하세요. 아래 버튼을 클릭하여 IDE에 서버를 직접 설치할 수 있습니다:

MCP 설정을 관리하는 방법에 대한 지침은 Kiro 문서를 참조하세요.

~/.kiro/settings/mcp.json 파일에서:

{
"mcpServers": {
"strands-agents": {
...

MCP 설정을 관리하는 방법에 대한 지침은 Q Developer CLI 문서를 참조하세요.

~/.aws/amazonq/mcp.json 파일에서:

{
"mcpServers": {
"strands-agents": {
...

MCP 서버를 관리하는 방법에 대한 지침은 Claude Code 문서를 참조하세요.

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

MCP 설정을 관리하는 방법에 대한 지침은 Cline 문서를 참조하세요.

Cline에 다음 정보를 제공하십시오:

"Strands Agents를 위한 MCP 서버를 추가하고 싶습니다.
GitHub 링크는 다음과 같습니다: @https://github.com/strands-agents/mcp-server
추가해 줄 수 있나요?"

MCP 설정을 관리하는 방법에 대한 지침은 Cursor 문서를 참조하세요.

~/.cursor/mcp.json 파일에서:

{
"mcpServers": {
"strands-agents": {
...

MCP 설정을 관리하는 방법에 대한 지침은 VS Code 문서를 참조하세요.

mcp.json 파일에서:

{
"servers": {
"strands-agents": {
...

MCP Inspector를 사용하여 MCP 서버를 빠르게 테스트할 수 있습니다:

# 배포된 패키지의 경우
npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server
# 로컬 개발의 경우
...

참고: 이 작업은 시스템에 npx가 설치되어 있어야 합니다. npx는 Node.js와 함께 번들로 제공됩니다.

Inspector는 상세한 연결 및 프로토콜 정보를 제공하므로 MCP 서버 문제를 해결(troubleshooting)하는 데에도 유용합니다. 심층적인 가이드는 MCP Inspector 문서를 확인하세요.

필수 구성 요소 설치:

• 공식 설치 지침에 따라 uv를 설치하세요.

• npx 명령어를 위해 Node.js가 설치되어 있는지 확인하세요.

MCP 클라이언트 설정:

• 위의 설치 예시 중에서 선호하는 MCP 클라이언트를 선택하세요.

• 클라이언트에 Strands Agents MCP 서버 설정을 추가하세요.

연결 테스트:

배포된 패키지의 경우

npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server

로컬 개발의 경우

npx @modelcontextprotocol/inspector python -m strands_mcp_server

문서 도구 사용 시작:
search_docs: 지능형 랭킹(intelligent ranking)을 통해 관련 문서를 찾습니다.
fetch_doc: 페이지의 구조와 서문(preamble)을 탐색한 다음 개별 섹션을 읽습니다.

• 서버는 llms.txt 파일에서 큐레이션된 콘텐츠를 자동으로 인덱싱합니다.

git clone https://github.com/strands-agents/mcp-server.git
cd mcp-server
python3 -m venv venv
...

# 단위 테스트 (Unit tests) (빠름, 네트워크 접속 불필요)
pytest tests/
# 통합 테스트 (Integration tests) (strandsagents.com에 대한 네트워크 접속 필요)
...

통합 테스트 (Integration tests)를 건너뛰려면 (예: 네트워크 접속이 불가능한 CI 환경):

SKIP_INTEG_TESTS=1 pytest tests_integ/

여러분의 기여를 환영합니다! 다음 사항에 대한 자세한 내용은 기여 가이드 (Contributing Guide)를 참조하세요:

• 버그 및 기능 보고
• 개발 환경 설정
• Pull Requests를 통한 기여
• 행동 강령 (Code of Conduct)
• 보안 문제 보고

Discord에서 Strands 팀 및 다른 사용자들과 만나보세요.

이 프로젝트는 Apache License 2.0 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

더 많은 정보는 CONTRIBUTING을 참조하세요.