mcp-mifosx

Mifos X - AI - Apache Fineract®용 모델 컨텍스트 프로토콜(MCP)

이 프로젝트는 Apache Fineract API와 상호 작용하는 모델 컨텍스트 프로토콜(MCP) 서버를 제공하여 AI 에이전트가 재무 데이터 및 운영에 접근할 수 있도록 지원합니다. Python , Java(Quarkus) , Node.js 로 구현되어 있습니다.

MCP 개발자 도구

MCP Inspector를 사용하여 서버를 테스트하고 디버깅하세요.

지엑스피1

이렇게 하면 STDIO 또는 SSE를 통해 MCP 서버에 연결하는 로컬 웹 UI가 시작됩니다.

시작하기

1. 구현 선택

파이썬(플라스크)

필수 조건 : Python 3.8 이상, flask , mcp.server.fastmcp

단계 :

1. 종속성 설치:
   pip install mcp[cli] uv flask

   zsh 사용자를 위한 참고 사항 : zsh를 사용하는 경우 셸 확장 오류를 방지하려면 extras를 인용해야 합니다.

   pip install 'mcp[cli]' uv flask

2. 서버를 실행합니다:
   mcp dev app.py

자바(Quarkus)

필수 조건 : JDK 17+, Maven

단계 :

1. 셸이나 IDE에서 환경 변수를 구성하세요.
   export MIFOSX_BASE_URL="https://your-fineract-instance" export MIFOSX_BASIC_AUTH_TOKEN="your_api_token" export MIFOS_TENANT_ID="default"
2. JBang을 통해 실행(빠른 실행을 위해):
   jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner
3. (선택 사항) 네이티브 실행 파일을 빌드합니다.
   ./mvnw package -Dnative ./target/mcp-server-1.0.0-SNAPSHOT-runner

노드.js

필수 조건 : Node.js 16+, npm

단계 :

1. 종속성 설치:
   cd nodejs && npm install
2. .env 에서 환경 변수를 구성합니다.
   cp .env.example .env
3. 서버를 실행합니다:
   npm run dev
4. 내장된 inspect 스크립트로 테스트:
   npm run inspect

구성

모든 구현에는 다음 환경 변수가 필요합니다.

참고 : Java는 MIFOSX_ 접두사가 붙은 변수(예: MIFOSX_BASE_URL )를 사용합니다.

사용 가능한 리소스

MCP 서버는 다음 리소스를 제공합니다.

핵심 리소스

• fineract://clients
  모든 클라이언트 나열
• fineract://clients/{clientId}
  특정 클라이언트에 대한 세부 정보 가져오기
• fineract://loans
  모든 대출을 나열하세요
• fineract://loans/{loanId}
  특정 대출에 대한 세부 정보를 얻으세요

도구

• search_clients
  이름/속성으로 클라이언트 검색
• create_client
  새로운 클라이언트를 만듭니다(Node.js/Python만 해당)
• update_loan_status
  대출 상태 업데이트(Java/Python만 해당)

네이티브 실행 파일 빌드(Java 전용)

Java(Quarkus)의 경우 네이티브 실행 파일을 만듭니다.

MCP Inspector로 테스트

1. MCP 서버(Python/Java/Node.js)를 시작합니다.
2. 검사기를 실행합니다.
   npx @modelcontextprotocol/inspector
3. STDIO 전송을 사용하여 서버에 연결합니다.

기여하다

• Python : 새로운 리소스에 맞게 python/app.py 와 server.js 수정합니다.
• Java : 새로운 엔드포인트를 위해 src/main/java/org/mifos/community/ai/... 확장합니다.
• Node.js : nodejs/src/server.js 업데이트하고 검증을 위해 Zod 스키마를 추가합니다.

연락하다

• Apache Fineract 커뮤니티: https://community.apache.org/
• MCP 사양: https://modelcontextprotocol.org

가이드

• Java/Quarkus : Quarkus MCP 가이드
• Node.js : 라이브 리로딩을 위해 npm run inspect 사용하세요
• Python : python app.py 로 실행하고 .env 구성합니다.

주요 특징:

• fineract:// URI를 통한 표준화된 API 액세스
• STDIO/SSE 전송을 통한 MCP 호환
• 환경에 구애받지 않는 구성