Arca MCP 서버

Arca 프로젝트를 위해 TypeScript로 구현된 Model Context Protocol (MCP) 서버입니다.

구조

• src/tools/: 서버가 노출하는 도구(tools)입니다.

• src/commands/: 비즈니스 로직 및 명령어입니다.

• src/prompts/: 프롬프트 템플릿 및 컨텍스트입니다.

• src/vector_store/: 임베딩, 청킹 및 PostgreSQL과 pgvector를 이용한 영속성 로직입니다.

Related MCP server: ArcaMCP

기능 (Capabilities)

사용 가능한 도구 (Tools)

• query_arca_docs: AFIP 기술 문서에 대한 의미론적 검색(RAG)을 수행합니다.

• get_ta: .crt 및 .key 인증서를 사용하여 AFIP WSAA의 Ticket de Acceso(토큰 및 서명)를 획득하고 캐싱합니다.

• get_ultimo_comprobante: 특정 판매점에 대해 AFIP에서 승인된 마지막 전자 문서 번호를 조회합니다.

• create_invoice: AFIP에서 직접 전자 세금 계산서(A, B 또는 C 유형)를 생성 및 승인하고, VAT 금액을 자동 계산합니다.

사용 가능한 리소스 (Resources)

• resource://arca/guides/wsaa: AFIP 인증을 위한 단계별 가이드입니다.

• resource://arca/guides/invoice/{type}: 특정 전자 문서(A, B, C, MTXCA) 발행 가이드입니다.

요구 사항

• Node.js (v18+)

• Yarn

• pgvector 확장이 활성화된 PostgreSQL

설치

yarn install

사용법

IDE/CLI에서의 개발용(Stdio 방식):

yarn dev

로컬 개발 (HTTP 및 MCP Inspector)

네트워크를 통해 로컬에서 서버를 테스트하고 Inspector 웹 도구로 도구들을 디버깅하려면 다음 단계를 따르세요.

1. 서버를 HTTP(Streamable) 모드로 시작합니다.

   yarn run dev:http

   서버는 http://localhost:3001/mcp에서 수신 대기합니다.

2. MCP Inspector를 시작합니다. 프로젝트의 새 터미널을 열고 다음을 실행합니다.

   yarn run inspect

   그러면 브라우저 창이 열립니다.

3. Inspector를 로컬 서버에 연결합니다. Inspector의 웹 인터페이스에서 HTTP Streamable 전송을 설정할 수 있다면 http://localhost:3001/mcp로 지정하세요. 그렇지 않으면 Inspector를 표준 모드(Stdio)로 사용하여 로컬 index를 직접 가리키도록 실행할 수 있습니다(npx @modelcontextprotocol/inspector node dist/index.js). "Connect"를 클릭하면 서버가 노출하는 모든 도구(tools)가 나열되어 테스트할 준비가 됩니다.

프로덕션용으로 컴파일 및 실행:

yarn build
yarn start