presale-mcp 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +103 -0
- package/dist/index.js +3535 -0
- package/package.json +36 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Synergy Labs
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# presale-mcp
|
|
2
|
+
|
|
3
|
+
[](./LICENSE) 
|
|
4
|
+
|
|
5
|
+
자연어로 물어보면 인근 시설·분양공고·단지정보·실거래가를 조회해 **부동산 사업지 검토**를 돕는 로컬 MCP 서버입니다. Kakao/Naver/공공데이터포털 API를 사용하며, **DB·서버 배포 없이 내 컴퓨터에서 로컬 실행**합니다.
|
|
6
|
+
|
|
7
|
+
## Prerequisites
|
|
8
|
+
|
|
9
|
+
- Node.js >= 18
|
|
10
|
+
- Git
|
|
11
|
+
- MCP 클라이언트(Claude Desktop, Cursor, 기타 MCP 호환 클라이언트 등)
|
|
12
|
+
|
|
13
|
+
## Quick Start
|
|
14
|
+
|
|
15
|
+
### 1. 저장소를 내 컴퓨터로 복제
|
|
16
|
+
|
|
17
|
+
터미널에서 아래 명령을 실행합니다.
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
git clone https://github.com/chatdaeri/presale-mcp-oss.git
|
|
21
|
+
cd presale-mcp-oss
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### 2. 패키지 설치 및 빌드
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
npm install
|
|
28
|
+
npm run build
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
### 3. 파일 위치 확인
|
|
32
|
+
|
|
33
|
+
아래 명령을 실행하면 현재 폴더의 전체 경로가 표시됩니다.
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
pwd
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
예를 들어 Mac에서 `/Users/synergylabs/presale-mcp-oss`가 표시되었다면, 실제 실행 파일 경로는 아래와 같습니다.
|
|
40
|
+
|
|
41
|
+
```text
|
|
42
|
+
/Users/synergylabs/presale-mcp-oss/dist/index.js
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### 4. MCP 클라이언트 설정 파일 수정
|
|
46
|
+
|
|
47
|
+
Claude Desktop을 포함한 MCP 클라이언트의 설정 파일에 서버를 추가합니다. 기존 README의 `npx` 설정 대신, 방금 빌드한 로컬 파일을 Node.js로 실행하도록 아래와 같이 설정합니다. API 키 값은 **본인의 실제 키**로 교체하세요.
|
|
48
|
+
|
|
49
|
+
```json
|
|
50
|
+
{
|
|
51
|
+
"mcpServers": {
|
|
52
|
+
"presale-mcp": {
|
|
53
|
+
"command": "node",
|
|
54
|
+
"args": ["/Users/synergylabs/presale-mcp-oss/dist/index.js"],
|
|
55
|
+
"env": {
|
|
56
|
+
"NAVER_MAPS_CLIENT_ID": "실제키",
|
|
57
|
+
"NAVER_MAPS_CLIENT_SECRET": "실제키",
|
|
58
|
+
"KAKAO_REST_API_KEY": "실제키",
|
|
59
|
+
"DATA_GO_KR_SERVICE_KEY": "실제키"
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Windows에서는 `args`의 경로 구분자 `\\`를 두 번 써야 합니다. 예: `"C:\\Users\\synergylabs\\presale-mcp-oss\\dist\\index.js"`
|
|
67
|
+
|
|
68
|
+
## API 키 발급
|
|
69
|
+
|
|
70
|
+
| 키 | 발급처 | 용도 |
|
|
71
|
+
|---|---|---|
|
|
72
|
+
| `NAVER_MAPS_CLIENT_ID` / `NAVER_MAPS_CLIENT_SECRET` | Naver Cloud Platform — Maps(Geocoding, Static Map) | `get_geocode`(필수), `get_static_map` |
|
|
73
|
+
| `KAKAO_REST_API_KEY` | Kakao Developers — REST API 키 | 주소 후보, 법정동코드, 주변 카테고리/키워드 검색 |
|
|
74
|
+
| `DATA_GO_KR_SERVICE_KEY` | 공공데이터포털(data.go.kr) — 청약홈/K-apt/실거래가 서비스 신청 | 분양공고, 단지정보, 실거래가 |
|
|
75
|
+
|
|
76
|
+
> `DATA_GO_KR_SERVICE_KEY`는 서비스 신청 후 활성화까지 시간이 걸릴 수 있습니다. 키가 없으면 서버는 시작되지만 해당 도구 호출 시 에러를 반환합니다.
|
|
77
|
+
|
|
78
|
+
## 제공 도구 (10종)
|
|
79
|
+
|
|
80
|
+
| 도구 | 설명 | 필요 키 |
|
|
81
|
+
|---|---|---|
|
|
82
|
+
| `get_geocode` | 주소 → 좌표. Naver Geocoding 기반, Kakao 법정동 보강은 선택 | Naver 필수, Kakao 선택 |
|
|
83
|
+
| `get_address` | 단지명/장소명 → Kakao 주소 후보 | Kakao |
|
|
84
|
+
| `get_region_code` | 주소/지역명 → 법정동코드, 시군구코드, 청약홈 지역코드 | Kakao |
|
|
85
|
+
| `search_by_nearby_category` | 좌표 주변 카테고리 시설(학교·지하철·마트 등) | Kakao |
|
|
86
|
+
| `search_by_nearby_keyword` | 좌표 주변 키워드 검색(아파트·오피스텔 등) | Kakao |
|
|
87
|
+
| `search_presale_announcements` | 청약홈 APT 분양공고 목록 검색 | data.go.kr |
|
|
88
|
+
| `get_announcement_detail` | 청약홈 APT 공고 주택형/공급면적/세대수 상세 | data.go.kr |
|
|
89
|
+
| `get_complex_info` | K-apt 단지 기본/상세 정보 | data.go.kr |
|
|
90
|
+
| `get_complex_trades` | MOLIT 실거래가(매매/전월세/분양권 등) | data.go.kr |
|
|
91
|
+
| `get_static_map` | Naver Static Map 이미지 반환 | Naver |
|
|
92
|
+
|
|
93
|
+
## 주의사항
|
|
94
|
+
|
|
95
|
+
- **캐시가 없는 로컬 OSS 버전**입니다. 모든 호출은 본인 API 키의 쿼터를 직접 소모합니다.
|
|
96
|
+
- 공공데이터포털 API는 서비스별 신청/승인 상태와 일일 호출 한도의 영향을 받습니다.
|
|
97
|
+
- 이 서버는 데이터 조회 도구입니다. 적정 분양가 판단, 투자 판단, 법적/세무적 판단은 제공하지 않습니다.
|
|
98
|
+
- 각 API 제공처의 이용약관과 데이터 사용 조건을 준수하세요.
|
|
99
|
+
- hosted/유료 버전 안내는 이 공개 README에 포함하지 않습니다.
|
|
100
|
+
|
|
101
|
+
## License
|
|
102
|
+
|
|
103
|
+
MIT — see [LICENSE](./LICENSE).
|