헥토파이낸셜 MCP 서버
헥토파이낸셜의 연동 문서를 쉽고 빠르게 검색·조회할 수 있는 MCP 서버입니다.
MCP란? Model Context Protocol의 줄임말로, "AI를 위한 USB-C 포트"라고 불리며, LLM이 외부 데이터와 도구에 표준화된 방식으로 접근할 수 있게 해주는 프로토콜입니다.
📋 개요
이 MCP 서버는 헥토파이낸셜의 연동 문서를 검색하고, 개발자들이 필요한 정보를 빠르게 찾을 수 있도록 도와줍니다. 전자결제(PG), 내통장결제, 간편현금결제, 화이트라벨, 펌뱅킹, 선불, 현금영수증 서비스 관련 문서를 제공합니다.
서버 시작 시 헥토파이낸셜 공식 개발자 포털에서 최신 문서를 자동으로 가져오므로, 항상 최신 연동 가이드를 기준으로 답변합니다.
🛠️ 제공 도구
| 도구 | 설명 |
|---|---|
search_docs |
키워드 및 카테고리를 통해 헥토파이낸셜 연동 문서를 검색합니다. 카테고리(PG, 내통장결제, 간편현금결제, 화이트라벨)를 명시하면 검색 정확성이 향상됩니다. |
list_docs |
전체 연동 문서 목록을 조회합니다. 카테고리별(PG, 내통장결제, 간편현금결제, 화이트라벨) 필터링을 제공합니다. |
get_docs |
문서 ID 또는 파일명으로 특정 문서의 전체 내용을 조회합니다. |
search_error_code |
오류코드로 원인과 설명을 즉시 조회합니다. |
get_api_endpoint |
자연어 쿼리로 API URL과 HTTP 메서드를 추출합니다. |
get_api_params |
API 요청·응답 파라미터 테이블을 조회합니다. |
🚀 사용 방법
요구사항
- Python 3.10+
- uv 설치 필수
- MCP 클라이언트 (Cursor, Claude Desktop 등)
uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh
시맨틱 검색 활성화 (선택)
기본 설치는 BM25 키워드 검색만 사용합니다. 아래 옵션을 추가하면 BM25 + 시맨틱 하이브리드 검색이 활성화되어 검색 정확도가 향상됩니다.
pip install "hectofinancial-mcp-server[semantic]"
또는 uvx 실행 시:
{
"mcpServers": {
"hecto-financial": {
"command": "uvx",
"args": ["hectofinancial-mcp-server[semantic]@latest"]
}
}
}
🖇️ MCP 클라이언트 연동
Cursor
또는 프로젝트 루트에 .cursor/mcp.json 파일을 생성:
{
"mcpServers": {
"hecto-financial": {
"command": "uvx",
"args": ["hectofinancial-mcp-server@latest"]
}
}
}
VS Code
수동 설정 방법:
- VS Code에서
Ctrl+Shift+P(또는Cmd+Shift+P)를 눌러 명령 팔레트 열기 - "Preferences: Open User Settings (JSON)" 검색 후 선택
settings.json파일에 다음 설정 추가:
{
"mcp": {
"servers": {
"hectofinancial-mcp-server": {
"command": "uvx",
"args": [
"hectofinancial-mcp-server@latest"
]
}
}
}
}
Claude Desktop
~/.claude_desktop_config.json 파일에 추가:
{
"mcpServers": {
"hecto-financial": {
"command": "uvx",
"args": ["hectofinancial-mcp-server@latest"]
}
}
}
기타 MCP 클라이언트
다른 MCP 클라이언트에서도 다음과 같은 설정을 사용할 수 있습니다:
{
"mcpServers": {
"hecto-financial": {
"command": "uvx",
"args": ["hectofinancial-mcp-server@latest"]
}
}
}
💬 사용 예시
MCP 클라이언트(Cursor, Claude Desktop 등)에서 다음과 같은 질문들을 시도해보세요:
🔍 연동 가이드 검색
- "헥토파이낸셜 신용카드 결제 연동 방법 알려줘"
- "내통장결제 API 호출 어떻게 해?"
- "간편현금결제 휴대폰 인증 구현법 찾아줘"
- "화이트라벨 서비스 사용법 알려줘"
🔧 실제 구현 질문
- "PG에서 결제 승인 후 noti 처리는 어떻게 해?"
- "내통장결제에서 테스트 환경 URL과 상용 환경 URL 차이점은?"
- "간편현금결제에서 정기결제 등록하는 방법 알려줘"
- "PG에서 결제 취소 API 사용법은?"
🔎 오류코드 및 API 조회
- "0031 오류 원인이 뭐야?"
- "결제승인 API 요청 파라미터 보여줘"
- "가상계좌 채번 API 엔드포인트 URL 알려줘"
- "What is the API endpoint for virtual account payment?"
📄 License
This project is licensed under the MIT License.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hectofinancial_mcp_server-0.4.1.tar.gz.
File metadata
- Download URL: hectofinancial_mcp_server-0.4.1.tar.gz
- Upload date:
- Size: 581.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6999951fe434369c9553c1e3f0f1ec5ab950765365258b023bbe6c609f553319
|
|
| MD5 |
c864a03621edb5c6ca67daab4aa6a2f2
|
|
| BLAKE2b-256 |
5db3cbbc40647ee4d07762dffbaf0b4bb85a1bcfb72bde5a425e847cd0027785
|
File details
Details for the file hectofinancial_mcp_server-0.4.1-py3-none-any.whl.
File metadata
- Download URL: hectofinancial_mcp_server-0.4.1-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1e748900496010b89c02d11b45eca037f4f5dfa1281ed2466bcbc542c0af24b1
|
|
| MD5 |
a481b92f4838eee67760aef5960dc1a5
|
|
| BLAKE2b-256 |
2c77e773198ba514c83e687ad4ed281a03454f6eaae4d563dc0d77eb08b4be28
|
