Metadata-Version: 2.4
Name: hectofinancial-mcp-server
Version: 0.1.2
Summary: 헥토파이낸셜 결제 연동을 위한 MCP 서버입니다. 공식 연동 가이드 문서를 검색하고 조회하여 개발자들이 정확한 정보로 결제 시스템을 구축할 수 있도록 도와줍니다.
Author-email: hectofinancial <pg_dev@hecto.co.kr>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: fastmcp
Requires-Dist: mistune
Dynamic: license-file

# 헥토파이낸셜 MCP 서버

헥토파이낸셜의 연동 문서를 쉽고 빠르게 검색·조회할 수 있는 MCP(Model Context Protocol) 서버입니다.

> **MCP란?** "AI를 위한 USB-C 포트"라고 불리며, LLM이 외부 데이터와 도구에 표준화된 방식으로 접근할 수 있게 해주는 프로토콜입니다.

## 📋 개요

이 MCP 서버는 헥토파이낸셜의 연동 문서를 검색하고, 개발자들이 필요한 정보를 빠르게 찾을 수 있도록 도와줍니다. 전자결제(PG), 내통장결제, 간편현금결제 서비스 관련 문서를 제공합니다.

### 🛠️ 제공 도구

| 도구 | 설명 |
|------|------|
| **`search_docs`** | 키워드 및 카테고리를 통해 헥토파이낸셜 연동 문서를 검색합니다. 카테고리를 명시하면 검색 정확성이 향상됩니다. |
| **`list_docs`** | 전체 연동 문서 목록을 조회합니다. 카테고리별 필터링, 정렬 및 페이징을 제공합니다. |
| **`get_docs`** | 문서 ID 또는 파일명으로 특정 문서의 전체 내용을 조회합니다. |

## 🚀 사용 방법

### 요구사항
- Python 3.10+
- uv 설치 필수
- MCP 클라이언트 (Cursor, Claude Desktop 등)

### uv 설치
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

## 🖇️ MCP 클라이언트 연동

### Cursor
**🔗 원클릭 설정:** [Cursor에서 바로 설정하기](cursor://anysphere.cursor-deeplink/mcp/install?name=hectofinancial-mcp-server&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJoZWN0b2ZpbmFuY2lhbC1tY3Atc2VydmVyQGxhdGVzdCJdfQo=)

또는 프로젝트 루트에 `.cursor/mcp.json` 파일을 생성:

```json
{
  "mcpServers": {
    "hecto-financial": {
      "command": "uvx",
      "args": ["hectofinancial-mcp-server@latest"]
    }
  }
}
```

### Claude Desktop
`~/.claude_desktop_config.json` 파일에 추가:

```json
{
  "mcpServers": {
    "hecto-financial": {
      "command": "uvx",
      "args": ["hectofinancial-mcp-server@latest"]
    }
  }
}
```

### GitHub Copilot
VS Code에서 `settings.json`에 추가:

```json
{
  "github.copilot.chat.mcp.servers": {
    "hecto-financial": {
      "command": "uvx",
      "args": ["hectofinancial-mcp-server@latest"]
    }
  }
}
```

## 📄 License

This project is licensed under the MIT License.
