liaokongvfx/mcp-chinese-getting-started-guide

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

3.6천 stars 234 forks 품질 66 트렌드 27

Repository Install

모델 컨텍스트 프로토콜(MCP) - 프로그래밍 빠른 시작

개요

모델 컨텍스트 프로토콜(MCP)은 대형 언어 모델(LLM)이 외부 세계와 상호작용하는 방식을 재정의하는 혁신적인 오픈 소스 프로토콜입니다. MCP는 어떤 대형 언어 모델도 다양한 데이터 소스와 도구에 쉽게 연결할 수 있도록 표준화된 접근법을 제공하여 정보를 원활하게 접근하고 처리할 수 있게 합니다. MCP는 AI 애플리케이션의 USB-C 인터페이스처럼 기능하며, AI 모델에게 다양한 데이터 소스와 도구를 표준화된 방식으로 연결할 수 있도록 합니다. - 리소스 - 프롬프트 - 도구 - 샘플링 - 루츠 - 전송 전송 계층 대부분의 함수가 실제로 Claude 클라이언트를 지원하기 때문에, 이 글은 MCP 서버 서비스와 일반적인 대형 언어 모델을 작성하는 데 중점을 두므로, 이 글은 주로 "도구"에 초점을 맞추고, 다른 기능들은 마지막에 간략히 설명할 것입니다. 그중 MCP의 전송 계층은 두 가지 프로토콜을 지원합니다: stdio(표준 입출력)와 SSE(서버 이벤트 전송). stdio가 더 널리 사용되기 때문에, 이 글에서는 stdio를 설명의 예로 사용하겠습니다. 이 글은 파이썬 3.11 버전을 사용해 UV로 파이썬 프로젝트를 관리할 것입니다. 기사 마지막에 코드가 GitHub에 게시될 예정입니다. 더 이상 지체하지 않고, 시작해 봅시다~ 이 섹션에서는 웹 검색용 서버를 구현할 것입니다. 먼저, UV를 사용해 프로젝트를 초기화할 것입니다. 다음으로, web_search.py라는 파일을 만들어 서비스를 구현해 보겠습니다. MCP는 두 가지 객체를 제공합니다: mcp.server.fastMCP와 mcp.server.Server. mcp.server.FastMCP는 상위 레벨 캡슐화이며, 여기서는 이를 사용할 것입니다. 구현은 매우 간단합니다. MCP는 @mcp.tool()를 제공합니다. 이 데코레이터로 구현 함수를 꾸미기만 하면 됩니다. 함수 이름은 도구 이름, 매개변수는 도구 매개변수이며, 도구, 매개변수, 반환값은 주석으로 설명됩니다.

개요(AI 번역)

[목함]

서론

MCP는 다음과 같은 핵심 기능을 가지고 있습니다:

자료
프롬프트: 프롬프트 단어
도구
표본 추출
뿌리
전송 계층

대부분의 함수가 실제로 Claude 클라이언트를 지원하기 때문에, 이 글은 MCP 서버 서비스와 일반적인 대형 언어 모델을 작성하는 데 중점을 두므로, 이 글은 주로 "도구"에 초점을 맞추고, 다른 기능들은 마지막에 간략히 설명할 것입니다.

그중 MCP의 전송 계층은 두 가지 프로토콜을 지원합니다: stdio(표준 입출력)와 SSE(서버 이벤트 전송). stdio가 더 널리 사용되기 때문에, 이 글에서는 stdio를 설명의 예로 사용하겠습니다.

이 글은 파이썬 3.11 버전을 사용해 UV로 파이썬 프로젝트를 관리할 것입니다. 기사 마지막에 코드가 GitHub에 게시될 예정입니다. 더 이상 지체하지 않고, 시작해 봅시다~

MCP 서버 개발

이 섹션에서는 웹 검색용 서버를 구현할 것입니다. 먼저, UV를 사용해 프로젝트를 초기화할 것입니다.

UV 공식 문서: https://docs.astral.sh/uv/

다음으로, 서비스를 구현하기 위해 web_search.py이라는 파일을 만들겠습니다. MCP는 두 개의 객체를 제공합니다: mcp.server.FastMCP와 mcp.server.Server. mcp.server.FastMCP는 상위 수준 패키지로, 여기서 사용할 것입니다.

구현 방법은 매우 간단합니다. MCP는 @mcp.tool()를 제공하는데, 이 데코레이터로 구현 기능을 꾸미기만 하면 됩니다. 함수 이름은 도구 이름, 매개변수는 도구 매개변수이며, 도구와 매개변수는 주석과 반환 값으로 설명됩니다.

여기서는 직접 Zhipu 인터페이스를 사용합니다. 이 인터페이스는 관련 결과 링크를 검색하는 데 도움을 줄 뿐만 아니라, 그 링크들로부터 기사 요약도 생성해줍니다. ~~, 현재는 무료입니다~~(이미 요금이 시작되어 항목당 0.03위안입니다). 저희에게 매우 적합합니다.

공식 문서: https://bigmodel.cn/dev/api/search-tool/web-search-pro

API 키 생성 주소: https://bigmodel.cn/usercenter/proj-mgmt/apikeys

마지막으로 서버를 실행하는 코드를 추가하겠습니다.

MCP 서버 디버깅

이 시점에서 MCP 서버 작성이 완료됩니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

설치

npx -y @modelcontextprotocol/inspector <command> <arg1> <arg2>

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "web-search-server": {
      "command": "uv",
      "args": [
        "--directory",
        "D:/projects/mcp_getting_started",
        "run",
        "web_search.py"
      ]
    }
  }
}