Cursor·Claude와 내 메모장 연결하기: FastMCP로 5분 만에 나만의 MCP 서버 만드는 방법

Haram

@haram

Cursor·Claude와 내 메모장 연결하기: FastMCP로 5분 만에 나만의 MCP 서버 만드는 방법

Cursor·Claude와 내 메모장 연결하기: FastMCP로 5분 만에 나만의 MCP 서버 만드는 방법

매일 쓰는 컴퓨터 메모장의 텍스트를 AI가 실시간으로 읽고 정리해 준다면 얼마나 편할까요? 지금까지는 귀찮게 파일 내용을 매번 복사해서 붙여넣어야 했지만, 이제는 모델 컨텍스트 프로토콜(MCP) 덕분에 AI가 내 로컬 파일을 직접 읽고 활용할 수 있습니다. 복잡한 코딩이나 네트워크 설정 없이 단 5분 만에 나만의 메모장 서버를 만드는 가장 쉬운 방법을 소개해 드릴게요!

MCP 서버, 왜 직접 만들어야 할까요?

AI를 쓰다 보면 매번 똑같은 파일을 업로드하거나 메모장의 내용을 복사해서 붙여넣는 일이 가장 귀찮게 느껴집니다. 내 컴퓨터에 있는 메모장을 AI가 알아서 읽고 정리해 준다면 업무 효율이 훨씬 더 올라갈 텐데 말이죠.

MCP는 바로 이 아쉬움을 해결해 주는 든든한 연결 다리입니다. 복잡한 클라우드 서버를 구축하거나 까다로운 보안 설정을 하지 않아도, 내 로컬 환경과 AI 도구를 안전한 직통선으로 바로 연결할 수 있습니다.

특히 앤트로픽과 프리펙트가 함께 선보인 FastMCP를 활용하면 도구 연동의 진입장벽이 완전히 사라집니다. 복잡한 네트워크 통신 코드를 짤 필요 없이, 평소에 쓰는 아주 짧은 코드 몇 줄만으로 나만의 데이터를 다루는 강력한 비서를 직접 완성할 수 있습니다.

파이썬 코딩 7줄로 끝내는 초간단 메모장 서버

파이썬 환경에서는 FastMCP 패키지를 사용해 믿기 힘들 정도로 쉽게 MCP 서버를 만들 수 있습니다. 복잡한 통신 규격을 설정할 필요 없이, 일반 파이썬 함수에 데코레이터 하나만 얹어주면 AI가 알아서 도구를 인식합니다. AI가 함수의 타입 힌트와 설명글을 스스로 분석해 규격을 자동 변환해 주기 때문입니다.

터미널에서 pip install fastmcp 명령어로 패키지를 설치한 뒤 바로 사용할 수 있습니다. 지정된 경로의 메모장 파일을 읽어오는 핵심 코드는 다음과 같이 단 몇 줄로 완성됩니다.

python
from fastmcp import FastMCP
mcp = FastMCP("Notepad Server")

@mcp.tool()
def read_notepad(file_path: str) -> str:
    """로컬 메모장 텍스트 파일의 내용을 읽어옵니다."""
    with open(file_path, 'r', encoding='utf-8') as f:
        return f.read()

if __name__ == "__main__":
    mcp.run()

이 짧은 코드로 실행되는 서버 덕분에, Cursor나 Claude가 내 컴퓨터 안의 텍스트 파일을 막힘없이 읽고 대답할 수 있는 완벽한 연동 준비가 끝납니다.

타입스크립트와 Zod로 메모장 서버 빌드하기

자바스크립트나 타입스크립트가 더 편한 개발자분들도 걱정할 필요 없습니다. npm에 있는 FastMCP 패키지와 데이터 검증 라이브러리인 Zod를 사용하면 동일한 서버를 정말 깔끔하게 구현할 수 있습니다.

타입스크립트 기반의 FastMCP는 도구의 매개변수 타입을 정의할 때 Zod를 기본으로 지원합니다. 덕분에 AI가 도구를 호출할 때 어떤 형식으로 값을 넘겨주어야 하는지 안전하고 정확하게 가이드해 줍니다.

먼저 터미널에서 npm install fastmcp zod를 실행하여 필요한 패키지를 설치한 뒤, 아래 코드를 작성하면 끝입니다.

typescript
import { FastMCP } from 'fastmcp';
import { z } from 'zod';
import * as fs from 'fs';

const server = new FastMCP({
  name: 'Notepad Server',
  version: '1.0.0'
});

server.addTool({
  name: 'read_notepad',
  description: 'Reads the contents of a local notepad text file.',
  parameters: z.object({
    filePath: z.string().describe('Absolute path to the text file')
  }),
  execute: async ({ filePath }) => {
    return fs.readFileSync(filePath, 'utf-8');
  }
});

server.start({ transportType: 'stdio' });

코드가 아주 깔끔하고 직관적이죠? 이제 이 서버를 실행해 주기만 하면 표준 입출력 방식을 통해 AI가 내 PC의 로컬 메모장 파일을 비동기로 안전하게 읽어갈 수 있습니다.

Cursor와 Claude Desktop에 1분 만에 등록하는 방법

서버 코드를 완성했다면 이제 내가 사용하는 AI 도구인 Cursor나 Claude Desktop에 이 서버를 연결할 차례입니다.

가장 편리한 점은 별도로 서버를 항상 켜둘 필요가 없다는 것입니다. 표준 입출력 방식을 통해 동작하므로, AI가 필요할 때 알아서 백그라운드에서 우리 서버를 실행하고 메모장 내용을 읽어온 뒤 자동으로 종료합니다.

Claude Desktop의 설정 파일에 아래와 같이 몇 줄의 설정만 추가해 주면 바로 연동할 수 있습니다.

json
{
  "mcpServers": {
    "my-notepad": {
      "command": "python",
      "args": [
        "/절대경로/notepad_server.py"
      ]
    }
  }
}

타입스크립트로 만드셨다면 command에 npx를, args에 ["tsx", "/절대경로/server.ts"] 형태를 넣어 실행하도록 등록하시면 됩니다. 이때 파일 경로는 반드시 단축 경로가 아닌 절대 경로로 적어주어야 인식 오류가 나지 않습니다.

설정을 저장하고 AI 도구를 재실행하면 모든 준비가 끝납니다. 이제 채팅창에 "내 메모장에 적힌 오늘 할 일 요약해 줘"라고 요청해 보세요. AI가 스스로 로컬 메모장 파일을 읽어와서 상냥하게 정리해 주는 놀라운 경험을 하시게 될 겁니다!

나만의 맞춤형 AI 도구, 지금 시작해 보세요

FastMCP 덕분에 복잡한 설정 없이도 단 몇 줄의 코드만 있으면 내 로컬 데이터를 AI와 바로 연결할 수 있습니다. 오늘 함께 만들어본 메모장 읽기 도구처럼, 아주 작은 기능 하나가 일하는 생산성을 완전히 바꾸는 시작점이 됩니다.

그동안 AI를 단순히 질문하고 답변을 받는 도구로만 쓰셨다면, 이제는 내 로컬 환경과 연동해 직접 나만의 비서로 업그레이드해 보세요. 작은 메모장 읽기부터 시작해 나중에는 데이터베이스 조회나 자동화 워크플로우까지, 나만의 맞춤형 도구를 하나씩 늘려가는 재미를 꼭 느껴보셨으면 좋겠습니다!

아직 댓글이 없습니다.