Claude MCP 사용 (.asdf 사용자를 위한)

Claude MCP 란?

MCP에 대한 설명은 앤트로픽의 블로그로 대체하겠습니다!

https://www.anthropic.com/news/model-context-protocol

 

https://docs.anthropic.com/en/docs/agents-and-tools/mcp?q=mcp

Model Context Protocol (MCP) - Anthropic

이건 mcp 공식 문서

https://modelcontextprotocol.io/introduction

Introduction - Model Context Protocol

여긴 mcp 서버 사용할 수 있는 github repository

https://github.com/modelcontextprotocol/servers

GitHub - modelcontextprotocol/servers: Model Context Protocol Servers

 

이중에서 나는 brave search 를 사용해보려고한다. chatgpt는 그래도 웹 검색이 있고 deep research도 웹에 있는 자료를 계속 리서치 하는 것 같은데 클로드는 그런게 없었는데 brave search를 이용하면 웹에 있는 자료도 쉽게 검색할 수 있는 장점이 있다! 근데 유료임 그래도 무료 사용자한테도 월 2000건 까지는 공짜인 것 같으니 미리미리 써보자.

 

결국 이 글을 쓰는 이유는  다른 블로그들 자료 보면 사용방법이 천차만별이기도하고 어느정도 통일이 되어있지만 나는 그 방법으로 하면 잘 안되었음. 왜냐? 난 asdf를 쓰기 때문이다... 이걸 알게된건 개발자 이희승님의 유튜브를 보다가 알게되었다..

 

asdf란 쉽게 얘기해서 여러 언어(Ruby, Node.js, Python, Java 등)와 도구의 버전을 단일 인터페이스에서 관리할 수 있도록 해주는 플러그인 기반의 버전 관리자이다.

 

여기서 node나 java, kotlin, python 등을 설치해서 쓰는데 .asdf로 사용하는걸로 블로그에 나와있는 mcp 적용하면 잘안됨.. 계속 오류나서 열심히 구글링 해보니 역시 있다. 

 

뭐 다들 그냥 어떻게 설정했는지만 궁금할테니 여기에 내가 설정한 방법

{
  "mcpServers": {
    "brave-search": {
      "command": "/Users/username/.asdf/shims/npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY",
        "PATH": "/Users/username/.asdf/shims:/opt/homebrew/bin:/usr/bin:/bin",
        "ASDF_NODEJS_VERSION": "22.14.0"
      }
    }
  }
}

 

참고

https://dev.to/cojiroooo/mcp-using-node-on-asdf-382n

MCP using node on asdf

https://zenn.dev/nekorush14/articles/d46635473779b0

Claude DesktopでのBrave Search MCP Serverセットアップがasdf環境下で詰まった原因とその解決策