@valueofspace/mcp/README.md

공간의가치 MCP 서버

# 공간의가치 MCP 서버

공간의가치 API를 위한 Model Context Protocol (MCP) 서버입니다.

## 기능

-   키워드(주소, 건물명)로 자산 정보 검색
    -   주소 정보 (일반 주소, 도로명 주소)
    -   건물 정보 (건물명)
    -   가격 정보 (추정가)
    -   PNU 정보 (자산 PNU, PNU, PNU 목록)
    -   좌표 정보 (X, Y)
    -   면적 정보 (건축면적, 대지면적)
    -   용도 정보 (최대용도, 최대용도명)
    -   기타 정보 (우편번호, 건물관리번호, 도로명주소 상세, 집합건물 여부)

## Cursor에서 사용하기

1. `.cursor/mcp.json` 파일 생성 또는 수정:

```json
{
    "mcpServers": {
        "valueofspace": {
            "command": "npx",
            "args": ["-y", "@valueofspace/mcp"],
            "env": {
                "VOS_API_KEY": "your-api-key-here"
            }
        }
    }
}
```

## Claude Desktop에서 사용하기

1. `claude_desktop_config.json` 파일에 다음 설정 추가:

```json
{
    "mcpServers": {
        "valueofspace": {
            "command": "npx",
            "args": ["-y", "@valueofspace/mcp"],
            "env": {
                "VOS_API_KEY": "your-api-key-here"
            }
        }
    }
}
```

## npx로 직접 실행하기

```bash
# 환경 변수 설정
export VOS_API_KEY="your-api-key-here"

# npx로 실행
npx @valueofspace/mcp
```

> **참고**:
>
> -   `your-api-key-here`를 실제 공간의가치 API 키로 변경하세요.
> -   환경 변수는 `env` 객체를 통해 설정할 수 있습니다.

## 라이선스

이 프로젝트는 MIT 라이선스를 따릅니다. 자세한 내용은 LICENSE 파일을 참조하세요.