무제한 MCP 서버(v0.1.0)

Limitless API를 통해 Limitless Pendant 데이터를 Claude, Windsurf 등의 AI 도구에 연결하는 MCP(Model Context Protocol) 서버입니다. AI 채팅 인터페이스와 에이전트가 구조화되고 프로그래밍 가능한 방식으로 Lifelog와 상호 작용할 수 있도록 지원합니다. 한 번에 하나의 컨텍스트가 풍부한 상호 작용을 통해 더욱 체계적이고 지능적인 미래를 만들어 갑시다.

MCP란 무엇인가요?
모델 컨텍스트 프로토콜(Model Context Protocol) 은 AI 모델을 외부 도구 및 데이터에 연결하는 개방형 표준입니다. USB-C 포트나 AI용 HTTP 프로토콜과 같은 개념으로, 범용적이고 안정적이며 확장성을 고려하여 설계되었습니다. 모두가 채택하는 표준입니다. 풍부한 통합, 맞춤형 워크플로, 그리고 AI와 일상적으로 사용하는 도구 간의 원활한 통신을 지원합니다.

중요 참고: 2025년 3월부터 Limitless API는 Limitless Pendant를 통해 기록된 데이터를 필요로 합니다 . 이 서버는 Limitless Pendant에서 기록된 실제 데이터에 의존하며, 이 데이터가 없으면 의미 있는 결과를 반환하지 않습니다. Pendant가 연결되어 있고 기록 중인지 확인하세요.

API 상태 및 향후 계획:

공식 Limitless API는 현재 베타 버전 입니다. 따라서 가끔 불안정하거나, 변경되거나, 일시적인 서비스 중단이 발생할 수 있습니다.
대량의 데이터 요청(예: 수백 개의 로그 나열 또는 검색) 시 API 또는 네트워크 제약으로 인해 시간 초과 오류(예: 504 게이트웨이 시간 초과)가 발생할 수 있습니다. 서버는 이를 완화하기 위해 API 호출당 120초의 시간 초과를 설정하지만, 매우 큰 규모의 요청은 여전히 실패할 수 있습니다.
Limitless API는 현재 활발하게 개발 중입니다. 이 MCP 서버는 공식 API에 새로운 기능과 개선 사항이 추가되는 대로 업데이트될 예정입니다.
이 MCP 서버의 버전 0.2.0은 이미 개발 중이며, 가까운 미래에 더욱 강력한 기능과 잠재적으로 새로운 도구를 추가할 계획입니다!

기능(v0.1.0)

라이프로그 목록/가져오기: 펜던트 녹음 파일을 ID, 날짜, 날짜 범위별로 검색하거나 최근 항목을 나열합니다. 정렬 방향( asc / desc )도 제어할 수 있습니다.
최근 로그 검색: 구성 가능한 수의 최근 펜던트 녹음 내용 내에서 간단한 텍스트 검색을 수행합니다(참고: 최근 로그만 검색 가능하며, 전체 기록 검색은 지원되지 않습니다).

이 서버를 사용하면 Lifelog에서 작업 항목을 끌어와 Claude, ChatWise, Windsurf 또는 MCP를 지원하는 다른 AI 어시스턴트/앱을 통해 Notion으로 직접 보내는 등의 작업을 수행할 수 있습니다.

필수 조건

Node.js(v18 이상 필요)
npm 또는 yarn
Limitless 계정 및 API 키( 여기서 받으세요 )
무한한 펜던트 (데이터 필요)
stdio 서버를 생성하고 환경 변수를 전달할 수 있는 MCP 클라이언트 애플리케이션(예: Claude, Windsurf, Cursor, ChatWise, ChatGPT(곧 출시!))

설정

이 프로젝트를 복제하거나 다운로드하세요.
디렉토리로 이동합니다:지엑스피1
종속성 설치:
npm install
코드를 작성하세요:
npm run build

구성(클라이언트 측)

이 서버는 MCP 클라이언트에서 실행될 때 LIMITLESS_API_KEY 환경 변수 로 제공될 것으로 예상합니다.

MCP 클라이언트 설정 파일에 서버 구성 블록을 추가해야 합니다. 아래는 이 블록을 첫 번째 서버로 추가하는지, 아니면 기존 서버와 함께 추가하는지에 따라 달라지는 두 가지 예시입니다.

예시 A: 첫 번째/유일한 서버로 추가

클라이언트의 구성 파일에 현재 빈 mcpServers 개체( "mcpServers": {} )가 있는 경우 이를 다음으로 바꾸세요.

{
  "mcpServers": {
    "limitless": {
      "command": "node",
      "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

예시 B: 기존 서버에 추가

mcpServers 객체에 이미 다른 서버가 포함되어 있는 경우(예: "notion": {...} ), "limitless" 블록을 그 옆에 추가하여 올바른 JSON 구문(항목 사이에 쉼표 사용)을 보장합니다.

{
  "mcpServers": {
    "some_other_server": {
      "command": "...",
      "args": ["..."],
      "env": {
        "EXAMPLE_VAR": "value"
      }
    },
    "limitless": {
      "command": "node",
      "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

중요한:

<FULL_FILE_PATH_TO_DIST_SERVER.js> 빌드된 서버 스크립트의 올바른 절대 경로 (예: /Users/yourname/Documents/MCP/mcp-limitless-server/dist/server.js )로 바꾸세요. 상대 경로는 클라이언트에 따라 안정적으로 작동하지 않을 수 있습니다.
<YOUR_LIMITLESS_API_KEY_HERE> 실제 Limitless API 키로 바꾸세요.
MCP 구성 파일에는 주석을 포함할 수 없습니다 . <YOUR_LIMITLESS_API_KEY_HERE> 와 같은 자리 표시자 텍스트를 제거하고 실제 키로 바꾸세요.

서버 실행(클라이언트를 통해)

npm start 직접 실행하지 마세요.

서버가 성공적으로 빌드되었는지 확인합니다( npm run build ).
위에 표시된 대로 MCP 클라이언트를 구성하세요.
MCP 클라이언트 애플리케이션을 시작하세요. 필요할 때 mcp-limitless-server 프로세스가 자동으로 실행됩니다.

노출된 MCP 도구(v0.1.0)

(자세한 내용은 src/server.ts 참조하거나 클라이언트를 통해 서버에 문의하세요.)

limitless_get_lifelog_by_id : 특정 ID로 단일 펜던트 녹음을 검색합니다.
limitless_list_lifelogs_by_date : 특정 날짜의 펜던트 녹음을 나열합니다.
limitless_list_lifelogs_by_range : 날짜/시간 범위 내의 펜던트 녹음을 나열합니다.
limitless_list_recent_lifelogs : 가장 최근의 Pendant 녹음을 나열합니다.
limitless_search_lifelogs : 최근 Pendant 녹음의 제목/내용을 검색합니다(범위가 제한됨!).

참고사항 및 제한사항

🚫 펜던트 필요
이 서버는 Limitless Pendant에서 생성된 데이터를 사용합니다.

🧪 API 베타 상태
Limitless API는 베타 버전이므로 가끔 불안정하거나 속도 제한이 발생할 수 있습니다. 대량 요청은 시간 초과(예: 504 오류)로 이어질 수 있습니다.

🔍 검색 범위
limitless_search_lifelogs 제한된 수의 최근 로그(기본 20개, 최대 100개)만 검색합니다. 전체 기록을 검색 하지 않으므로 , 더 광범위한 분석을 위해서는 목록 도구를 먼저 사용하세요.

⚠️ 오류 처리 및 시간 초과
API 오류는 MCP 오류 결과로 변환됩니다. 각 API 호출에는 120초의 시간 제한이 있습니다.

🔌 운송
이 서버는 stdio 사용하며 MCP 호환 클라이언트 앱에서 실행되도록 설계되었습니다.

기여하다

아이디어, 개선 사항 또는 피드백이 있으신가요? 이슈를 열거나 PR을 통해 의견을 남겨주세요. 기여는 언제나 환영합니다! 웨어러블 컨텍스트와 지능형 도구를 통해 가능성의 한계를 끊임없이 넓혀 나가도록 함께 노력해 주세요. https://github.com/ipvr9/mcp-limitless-server

Limitless MCP Server

Integrations