컨텍스트 뱅크 MCP

개요

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

특징

지식 기반을 쿼리하기 위해 새로운 채팅 세션을 만듭니다.
지식 기반에서 응답을 받으려면 채팅 세션에 메시지를 보내세요.
Onyx API에서 결과 형식 지정 및 표시

사용된 기술

타입스크립트
노드.js
모델 컨텍스트 프로토콜(MCP) SDK
데이터 검증을 위한 Zod
HTTP 요청을 위한 Axios

설치

지엑스피1

구성

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

자동 설정(권장)

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

npm run setup

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

.env 파일이 없으면 생성하세요.
AtherOS API 키를 입력하라는 메시지가 표시됩니다.
API 기반 URL을 사용자 정의할 수 있습니다.
다른 구성 옵션에 대한 기본값 설정

수동 설정

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

cp .env.example .env

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

# AtherOS API Configuration
ONYX_API_KEY=your_api_key_here
ONYX_API_BASE=http://your_api_base_url:port

# Server Configuration
PORT=3000
NODE_ENV=development

# Optional: Logging Configuration
LOG_LEVEL=info

환경 변수

필수 환경 변수:
- ONYX_API_KEY : AtherOS API 키
- ONYX_API_BASE : AtherOS API의 기본 URL(예: " http://172.30.22.52:3000 ")
선택적 환경 변수:
- PORT : 서버의 포트 번호 (기본값: 3000)
- NODE_ENV : 환경 모드(개발, 프로덕션, 테스트)
- LOG_LEVEL : 로깅 레벨(info, debug, error, warn)

용법

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

# Direct usage
./build/index.js

# Or through npm
npm start

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 프로토콜을 사용합니다.

개발

# Compile and view changes
npm run build

# Run in development mode
npm run dev

특허

아이에스씨

Integrations