docuking-mcp 1.0.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/DEPLOY_TASK.md +33 -0
- package/README.md +118 -0
- package/index.js +1594 -0
- package/package.json +30 -0
package/DEPLOY_TASK.md
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# MCP 패키지 배포 작업지시
|
|
2
|
+
|
|
3
|
+
## 작업 개요
|
|
4
|
+
docurepo-mcp 패키지 v1.0.5를 npm에 배포
|
|
5
|
+
|
|
6
|
+
## 변경 사항
|
|
7
|
+
- Push 시 Sync 상태 API 호출 추가
|
|
8
|
+
- 시작: `POST /projects/:id/sync/start` (totalFiles 전달)
|
|
9
|
+
- 진행: `POST /projects/:id/sync/progress` (5개마다)
|
|
10
|
+
- 완료: `POST /projects/:id/sync/complete`
|
|
11
|
+
|
|
12
|
+
## 배포 절차
|
|
13
|
+
|
|
14
|
+
### 1. npm 로그인 확인
|
|
15
|
+
```bash
|
|
16
|
+
cd c:\2025_Project\docurepo\docurepo-mcp
|
|
17
|
+
npm whoami
|
|
18
|
+
```
|
|
19
|
+
- 로그인 안되어 있으면: `npm login`
|
|
20
|
+
|
|
21
|
+
### 2. 패키지 배포
|
|
22
|
+
```bash
|
|
23
|
+
npm publish
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### 3. 배포 확인
|
|
27
|
+
```bash
|
|
28
|
+
npm view docurepo-mcp version
|
|
29
|
+
```
|
|
30
|
+
- 1.0.5가 나오면 성공
|
|
31
|
+
|
|
32
|
+
## 완료 후
|
|
33
|
+
- 사용자가 `npx docurepo-mcp` 재실행하면 새 버전 적용됨
|
package/README.md
ADDED
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# docurepo-mcp
|
|
2
|
+
|
|
3
|
+
문서용 Git - AI가 문서를 Push/Pull 할 수 있게 해주는 MCP 서버
|
|
4
|
+
|
|
5
|
+
## 설치
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npx docurepo-mcp
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## MCP 설정
|
|
12
|
+
|
|
13
|
+
### Claude Code (CLI/VSCode)
|
|
14
|
+
|
|
15
|
+
`~/.claude.json` 또는 프로젝트의 `.claude/settings.json`에 추가:
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"mcpServers": {
|
|
20
|
+
"docurepo": {
|
|
21
|
+
"command": "npx",
|
|
22
|
+
"args": ["docurepo-mcp"],
|
|
23
|
+
"env": {
|
|
24
|
+
"DOCUREPO_API_KEY": "sk_xxx",
|
|
25
|
+
"DOCUREPO_REPOS": "{\"C:/my-project\":\"project-uuid\"}"
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### Cursor
|
|
33
|
+
|
|
34
|
+
`~/.cursor/mcp.json`에 추가:
|
|
35
|
+
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"mcpServers": {
|
|
39
|
+
"docurepo": {
|
|
40
|
+
"command": "npx",
|
|
41
|
+
"args": ["docurepo-mcp"],
|
|
42
|
+
"env": {
|
|
43
|
+
"DOCUREPO_API_KEY": "sk_xxx",
|
|
44
|
+
"DOCUREPO_REPOS": "{\"C:/my-project\":\"project-uuid\"}"
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 도구
|
|
52
|
+
|
|
53
|
+
### docurepo_init
|
|
54
|
+
|
|
55
|
+
프로젝트를 DocuRepo에 연결합니다.
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+
docurepo_init(projectId, localPath)
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
- Z_DocuRepo/ 폴더 생성
|
|
62
|
+
- 레포 매핑 추가 안내
|
|
63
|
+
|
|
64
|
+
### docurepo_push
|
|
65
|
+
|
|
66
|
+
Z_DocuRepo/ 폴더의 문서를 서버에 업로드합니다.
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
docurepo_push(localPath, [filePath])
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
- "피터해" 요청 시 사용
|
|
73
|
+
- filePath 생략 시 전체 동기화
|
|
74
|
+
|
|
75
|
+
### docurepo_pull
|
|
76
|
+
|
|
77
|
+
서버에서 문서를 다운로드합니다.
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
docurepo_pull(localPath, [filePath])
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
- "피터에서 가져와" 요청 시 사용
|
|
84
|
+
- filePath 생략 시 전체 동기화
|
|
85
|
+
|
|
86
|
+
### docurepo_list
|
|
87
|
+
|
|
88
|
+
서버에 저장된 파일 목록을 조회합니다.
|
|
89
|
+
|
|
90
|
+
```
|
|
91
|
+
docurepo_list(localPath)
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
## 환경변수
|
|
95
|
+
|
|
96
|
+
| 변수 | 설명 |
|
|
97
|
+
|------|------|
|
|
98
|
+
| DOCUREPO_API_KEY | API 키 (필수) |
|
|
99
|
+
| DOCUREPO_API_ENDPOINT | API 엔드포인트 (기본: https://peeter.kr/api) |
|
|
100
|
+
| DOCUREPO_REPOS | 로컬경로 → projectId 매핑 (JSON) |
|
|
101
|
+
|
|
102
|
+
## 동기화 대상
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
프로젝트/
|
|
106
|
+
├── src/ ← 대상 아님
|
|
107
|
+
├── 기타/ ← 대상 아님
|
|
108
|
+
└── Z_DocuRepo/ ← 대상 (이 폴더만)
|
|
109
|
+
├── 정책/
|
|
110
|
+
├── 회의록/
|
|
111
|
+
└── 뭐든지/
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
**Z_DocuRepo/ 폴더만** 동기화됩니다.
|
|
115
|
+
|
|
116
|
+
## 라이센스
|
|
117
|
+
|
|
118
|
+
MIT
|