컨텍스트 뱅크 MCP

개요

Context Bank MCP는 모델 컨텍스트 프로토콜(MCP)을 사용하여 API를 통해 AtherOS 지식 베이스에 쿼리를 전송하는 인터페이스를 구축하는 프로젝트입니다. 이 프로젝트는 Onyx API와 상호 작용하여 채팅 세션을 생성하고 지식 베이스에 쿼리를 전송할 수 있는 MCP 서버를 구축합니다.

Related MCP server: Astro Docs MCP Server

특징

• 지식 기반을 쿼리하기 위해 새로운 채팅 세션을 만듭니다.

• 지식 기반에서 응답을 받으려면 채팅 세션에 메시지를 보내세요.

• Onyx API에서 결과 형식 지정 및 표시

사용된 기술

• 타입스크립트

• 노드.js

• 모델 컨텍스트 프로토콜(MCP) SDK

• 데이터 검증을 위한 Zod

• HTTP 요청을 위한 Axios

설치

지엑스피1

구성

이 프로젝트는 Onyx API에 연결하기 위해 환경 변수를 사용합니다. 다음 단계에 따라 환경을 구성하세요.

자동 설정(권장)

대화형으로 환경을 구성하려면 설치 스크립트를 실행하세요.

이 스크립트는 다음을 수행합니다.

1. .env 파일이 없으면 생성하세요.

2. AtherOS API 키를 입력하라는 메시지가 표시됩니다.

3. API 기반 URL을 사용자 정의할 수 있습니다.

4. 다른 구성 옵션에 대한 기본값 설정

수동 설정

1. 예제 환경 파일을 복사하여 나만의 환경 파일을 만드세요.

2. 특정 구성으로 .env 파일을 편집합니다.

환경 변수

1. 필수 환경 변수:

   • ONYX_API_KEY : AtherOS API 키

   • ONYX_API_BASE : AtherOS API의 기본 URL(예: " http://172.30.22.52:3000 ")

2. 선택적 환경 변수:

   • PORT : 서버의 포트 번호 (기본값: 3000)

   • NODE_ENV : 환경 모드(개발, 프로덕션, 테스트)

   • LOG_LEVEL : 로깅 레벨(info, debug, error, warn)

용법

컴파일 후 명령줄 도구를 사용할 수 있습니다.

API 도구

이 프로젝트는 두 가지 주요 MCP 도구를 제공합니다.

1. 채팅 세션 생성

지식 기반을 쿼리하기 위해 새로운 채팅 세션을 만듭니다.

매개변수:

• persona_id (기본값: 0): 사용자 ID

• description (기본값: ""): 채팅 세션 설명

2. 쿼리_아테로스

AtherOS 지식 기반을 쿼리하기 위해 채팅 세션에 메시지를 보냅니다.

매개변수:

• chat_session_id : 채팅 세션 ID

• message : 메시지 내용

• parent_message_id : 부모 메시지 ID(null일 수 있음)

응답 형식

지식 기반 질의에 대한 응답은 다음과 같습니다.

• 메시지 ID

• 메시지 내용

• 다시 표현된 질의(가능한 경우)

• 상위 소스 문서에 대한 정보(가능한 경우):

  • 문서 이름

  • 관련성 점수

  • 문서에 대한 링크

건축학

이 프로젝트는 간단한 구조로 구성되어 있습니다.

• src/index.ts : 애플리케이션의 주요 진입점으로 MCP 도구와 연결 논리를 정의합니다.

• MCP 서버와 통신하기 위해 stdio 프로토콜을 사용합니다.

개발

특허

아이에스씨