Skip to main content
Glama
Model Context Protocol (MCP) Server

Model Context Protocol (MCP) Server

by hideya

LangChain/Python을 사용하는 MCP 클라이언트 라이센스: MIT

이 간단한 MCP(Model Context Protocol) 클라이언트는 LangChain ReAct Agent의 MCP 서버 도구 사용을 보여줍니다.

langchain_mcp_tools 의 유틸리티 함수 convert_mcp_to_langchain_tools() 활용합니다.
이 함수는 지정된 여러 MCP 서버의 병렬 초기화를 처리하고 사용 가능한 도구를 LangChain 호환 도구 목록( List[BaseTool] )으로 변환합니다.

현재 Anthropic, OpenAI 및 Groq의 LLM이 지원됩니다.

이 MCP 클라이언트의 타입스크립트 버전은 여기에서 사용할 수 있습니다.

필수 조건

  • 파이썬 3.11+

  • [선택 사항] Python 패키지 기반 MCP 서버를 실행하기 위해 uv ( uvx ) 가 설치됨

  • [선택 사항] Node.js 패키지 기반 MCP 서버를 실행하려면 npm 7+( npx )가 필요합니다.

  • 필요에 따라 Anthropic , OpenAI 및/또는 Groq 의 API 키

Related MCP server: OpenAI and Claude MCP

설정

  1. 종속성 설치:

    지엑스피1

  2. API 키 설정:

    cp .env.template .env
    • 필요에 따라 .env 업데이트합니다.

    • .gitignore 는 자격 증명의 우발적 커밋을 방지하기 위해 .env 무시하도록 구성됩니다.

  3. 필요에 따라 LLM 및 MCP 서버 설정 llm_mcp_config.json5 구성합니다.

    • MCP 서버의 구성 파일 형식은 데스크톱용 Claude 와 동일한 구조를 따르지만, 한 가지 차이점이 있습니다. JSON 구성 파일에서 일반적으로 사용되는 snake_case 규칙을 따르기 위해 키 이름 mcpServers``mcp_servers 로 변경되었습니다.

    • 파일 형식은 JSON5 이며, 주석과 끝에 쉼표가 허용됩니다.

    • 이 형식은 ${...} 표기법을 해당 환경 변수의 값으로 대체하도록 더욱 확장되었습니다.

    • 모든 자격 증명과 개인 정보를 .env 파일에 보관하고 필요에 따라 ${...} 표기법을 사용하여 참조합니다.

용법

앱을 실행하세요:

make start

처음 실행할 때는 시간이 좀 걸립니다.

자세한 모드로 실행:

make start-v

명령줄 옵션을 참조하세요.

make start-h

프롬프트에서 Enter 키를 누르면 MCP 서버 도구 호출을 수행하는 예제 쿼리를 사용할 수 있습니다.

예제 쿼리는 llm_mcp_config.json5 에서 구성할 수 있습니다.

Available Tools

2 tools
get-alertsC

Get weather alerts for a US state

Inputs: state (required).

get-forecastB

Get weather forecast for a location in the US

Inputs: latitude (required), longitude (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The tools get-alerts and get-forecast have clearly distinct purposes: one provides weather alerts, the other gives forecasts. No overlap.

    Naming Consistency5/5

    Both tool names follow the consistent pattern 'get-<resource>', using lowercase and hyphens, which is predictable.

    Tool Count2/5

    With only 2 tools, the server feels too sparse for a weather domain. Typically, more operations like current conditions or radar would be expected.

    Completeness2/5

    The tool set only covers alerts and forecasts, missing common weather operations like current conditions, location search, or severe weather warnings, resulting in significant gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers