Vectorize MCP Server

Vectorize MCP 서버

고급 벡터 검색 및 텍스트 추출을 위해 Vectorize와 통합되는 모델 컨텍스트 프로토콜(MCP) 서버 구현체입니다.

설치

npx로 실행하기

export VECTORIZE_ORG_ID=YOUR_ORG_ID
export VECTORIZE_TOKEN=YOUR_TOKEN
export VECTORIZE_PIPELINE_ID=YOUR_PIPELINE_ID

npx -y @vectorize-io/vectorize-mcp-server@latest

VS Code 설치

원클릭 설치를 하려면 아래 설치 버튼 중 하나를 클릭하세요:

수동 설치

가장 빠른 설치를 원한다면 이 섹션 상단의 원클릭 설치 버튼을 사용하세요.

수동으로 설치하려면 VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P 키를 누르고 Preferences: Open User Settings (JSON)을 입력하면 됩니다.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "org_id",
        "description": "Vectorize Organization ID"
      },
      {
        "type": "promptString",
        "id": "token",
        "description": "Vectorize Token",
        "password": true
      },
      {
        "type": "promptString",
        "id": "pipeline_id",
        "description": "Vectorize Pipeline ID"
      }
    ],
    "servers": {
      "vectorize": {
        "command": "npx",
        "args": ["-y", "@vectorize-io/vectorize-mcp-server@latest"],
        "env": {
          "VECTORIZE_ORG_ID": "${input:org_id}",
          "VECTORIZE_TOKEN": "${input:token}",
          "VECTORIZE_PIPELINE_ID": "${input:pipeline_id}"
        }
      }
    }
  }
}

선택적으로, 워크스페이스의 .vscode/mcp.json 파일에 다음 내용을 추가하여 다른 사람들과 설정을 공유할 수 있습니다:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "org_id",
      "description": "Vectorize Organization ID"
    },
    {
      "type": "promptString",
      "id": "token",
      "description": "Vectorize Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "pipeline_id",
      "description": "Vectorize Pipeline ID"
    }
  ],
  "servers": {
    "vectorize": {
      "command": "npx",
      "args": ["-y", "@vectorize-io/vectorize-mcp-server@latest"],
      "env": {
        "VECTORIZE_ORG_ID": "${input:org_id}",
        "VECTORIZE_TOKEN": "${input:token}",
        "VECTORIZE_PIPELINE_ID": "${input:pipeline_id}"
      }
    }
  }
}

Claude/Windsurf/Cursor/Cline에서의 설정

{
  "mcpServers": {
    "vectorize": {
      "command": "npx",
      "args": ["-y", "@vectorize-io/vectorize-mcp-server@latest"],
      "env": {
        "VECTORIZE_ORG_ID": "your-org-id",
        "VECTORIZE_TOKEN": "your-token",
        "VECTORIZE_PIPELINE_ID": "your-pipeline-id"
      }
    }
  }
}

도구

문서 검색

벡터 검색을 수행하고 문서를 검색합니다 (공식 API 참조):

{
  "name": "retrieve",
  "arguments": {
    "question": "Financial health of the company",
    "k": 5
  }
}

텍스트 추출 및 청킹 (모든 파일을 Markdown으로)

문서에서 텍스트를 추출하고 Markdown 형식으로 청킹합니다 (공식 API 참조):

{
  "name": "extract",
  "arguments": {
    "base64document": "base64-encoded-document",
    "contentType": "application/pdf"
  }
}

심층 리서치

파이프라인에서 비공개 심층 리서치를 생성합니다 (공식 API 참조):

{
  "name": "deep-research",
  "arguments": {
    "query": "Generate a financial status report about the company",
    "webSearch": true
  }
}

개발

npm install
npm run dev

릴리스

package.json 버전을 변경한 후:

git commit -am "x.y.z"
git tag x.y.z
git push origin
git push origin --tags

기여하기

1. 저장소를 포크합니다
2. 기능 브랜치를 생성합니다
3. 풀 리퀘스트를 제출합니다