Knownbase MCP Server

Model Context Protocol을 통한 AI 에이전트용 영구적이고 검색 가능한 프로젝트 메모리.

Knownbase는 AI 코딩 에이전트(Claude, Cursor, ChatGPT, Claude Code, Windsurf 및 기타 MCP 호환 클라이언트)에게 git 기록 밖에 존재하는 지속적인 메모, 결정, 인수인계 사항을 읽고 쓸 수 있는 공간을 제공하는 호스팅형 MCP 서버입니다. 즉, 세션이 끝나는 순간 에이전트가 잃어버리는 작업 메모리를 제공합니다.

이 저장소는 /mcp 엔드포인트를 문서화합니다: 연결 방법, 노출되는 도구, 인증 작동 방식. 로컬 설치는 없습니다. Knownbase는 원격 스트리밍 HTTP MCP 서버이므로, 클라이언트를 URL에 연결하기만 하면 됩니다.

https://knownbase.dev/mcp

이 서비스가 해결하는 문제

AI 에이전트는 세션 간에 상태를 유지하지 않습니다. 새로운 채팅, 새 터미널, 재시작한 IDE 창은 모두 처음부터 시작합니다. 에이전트는 코드를 다시 읽지만 사물이 왜 그런 방식으로 되어 있는지에 대한 이유는 기억하지 못합니다:

• 아키텍처 결정과 그 배후의 트레이드오프

• 디버깅 기록("우리는 X를 시도했지만 Y 때문에 작동하지 않았다")

• 코드 자체만으로는 명확하지 않은 규칙과 함정

• 세션 간, 또는 사용자와 동료의 에이전트 간 작업 인수인계

• git 기록을 어지럽히고 싶지 않지만 에이전트가 알아야 하는 모든 것

메모리 레이어가 없으면 매 세션마다 같은 맥락을 다시 설명하게 되거나, 에이전트가 같은 것을 두 번 다시 발견(그리고 다시 망가뜨리는)하게 됩니다. Knownbase는 에이전트가 직접 검색하고 쓸 수 있는 작업 공간을 제공하여, 메모리가 초기화되지 않고 지속되고 축적되도록 합니다.

Related MCP server: Librarian

빠른 시작

1. knownbase.dev에서 무료 작업 공간을 만듭니다(카드 불필요).

2. MCP 클라이언트를 https://knownbase.dev/mcp에 연결합니다. 클라이언트별 정확한 단계는 docs/CONNECTING_CLIENTS.md를 참조하세요(Claude, Claude Code, ChatGPT, Cursor 및 일반 MCP 클라이언트).

3. 정적 API 키 또는 OAuth 2.1로 인증합니다(대부분의 클라이언트는 OAuth를 자동으로 발견합니다). docs/AUTHENTICATION.md를 참조하세요.

4. get_context로 작업을 시작하여 이미 알려진 내용을 불러오고, remember로 지속적인 지식을 기록하며, 직접 제어가 필요할 때는 search_notes / get_note / upsert_note를 사용하세요. 전체 도구 참조: docs/TOOLS.md.

제공하는 도구

메모는 선택적으로 유형화된 시간적 메타데이터(decision / fact / constraint / …, 그리고 current / superseded / disputed 라이프사이클)도 담고 있으며, get_context가 이를 기준으로 순위를 매기고 필터링합니다. 도구 참조의 유형화된 시간적 메모리를 참조하세요.

에이전트 토큰을 절약하도록 설계된 기본 간결 응답 형식을 포함한 전체 매개변수 수준 참조는 docs/TOOLS.md에 있습니다.

원격 호스팅형 MCP 서버인 이유

모든 메모는 사용자의 작업 공간에만 범위가 지정되며, 테넌트 간 공유되는 것은 없습니다. 전체 텍스트 검색(및 지원 요금제에서는 의미 기반 검색)이 서버 측에서 실행되므로, 에이전트는 전체 메모 코퍼스를 컨텍스트에 로드하지 않고도 결과를 얻을 수 있습니다. 메모는 버전 관리(모든 편집이 수정본으로 스냅샷됨)되고 소프트 삭제(영구 삭제가 아닌 휴지통)되므로, 에이전트의 쓰기는 절대 되돌릴 수 없는 문이 아닙니다.

링크

• 홈페이지: Knownbase가 무엇이고 누구를 위한 것인지

• 기능

• 요금제: 무료 티어(프로젝트 3개, 메모 300개, MCP 키 2개)와 Go / Solo / Team / Business 요금제, 각각 7일 무료 체험 제공

• 블로그: MCP, 에이전트 메모리 및 인수인계에 대한 가이드

• llms.txt: 기계가 읽을 수 있는 제품/엔드포인트 요약

• 문의 · hello@knownbase.dev

저장소 구성

• docs/AUTHENTICATION.md: API 키, OAuth 2.1 흐름, 프로젝트 범위 키

• docs/CONNECTING_CLIENTS.md: 클라이언트별 설정(Claude, Claude Code, ChatGPT, Cursor, 기타)

• docs/TOOLS.md: 입력/출력 형식을 포함한 전체 도구 참조

• server.json: MCP 레지스트리 매니페스트

이 저장소는 호스팅 서비스를 문서화하며, Knownbase 서버의 소스 코드를 포함하지 않습니다. 이 문서에서 문제를 발견했거나 실제 서버 동작과 불일치하는 부분이 있나요? 이슈를 열거나 hello@knownbase.dev로 이메일을 보내주세요.

라이선스

이 저장소의 문서는 MIT 라이선스를 따릅니다. Knownbase 서비스 자체의 사용은 서비스 약관의 적용을 받습니다.