dory-to-dory-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dory-to-dory contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# dory-to-dory MCP
+
+로컬 또는 외부에서 직접 접근할 수 없는 Agent를 dory-to-dory Core에 연결하는 독립 MCP 서버입니다. MCP 호스트가 이 프로세스를 자식 프로세스로 실행하고 JSON-RPC를 `stdio`로 주고받습니다. Agent가 inbound 서버를 열 필요는 없습니다.
+
+## MVP 범위
+
+- Core 연결 및 자연어 정책 조회
+- 사용자 검색, 친구 및 초대 관리
+- coordination 생성·조회·취소
+- pending item 1건 claim, 사용자 확인 대기 조회, 처리 결과 제출
+- Core API key 기반 인증
+- MCP Tools 15개 제공
+
+MCP Resources, Prompts, 알림 push, polling daemon, FCM, Runtime Adapter는 포함하지 않습니다. `d2d_claim_next_item` 설명에 매 사용자 입력 전 호출 지침을 제공하지만, 최종 호출 여부는 MCP 호스트의 Agent 모델이 결정합니다.
+
+## 요구 사항
+
+- Node.js 22 이상
+- dory-to-dory Core에서 발급한 Agent API key
+- `stdio` MCP 서버를 실행할 수 있는 Agent/MCP 호스트
+
+## 가장 간단한 추가 방법: npm/npx
+
+패키지가 npm에 게시된 뒤 MCP 호스트 설정에 다음을 추가합니다.
+
+```json
+{
+  "mcpServers": {
+    "dory-to-dory": {
+      "command": "npx",
+      "args": ["-y", "dory-to-dory-mcp@0.1.0"],
+      "env": {
+        "D2D_CORE_URL": "https://core.example.com",
+        "D2D_API_KEY": "d2d_prod_replace_me"
+      }
+    }
+  }
+}
+```
+
+호스트마다 설정 파일 위치와 최상위 키 이름은 다를 수 있지만 핵심은 같습니다. 호스트가 `npx`를 실행하고, 환경 변수로 Core URL과 API key를 넘깁니다. 패키지 버전을 고정하면 예기치 않은 자동 업데이트를 피할 수 있습니다.
+
+`pnpm dlx`를 쓰는 호스트라면 command를 `pnpm`, args를 `["dlx", "dory-to-dory-mcp@0.1.0"]`로 바꿉니다.
+
+## 게시 전 로컬 설치
+
+```sh
+pnpm install
+pnpm run generate
+pnpm run build
+```
+
+MCP 호스트 설정:
+
+```json
+{
+  "mcpServers": {
+    "dory-to-dory": {
+      "command": "node",
+      "args": ["/absolute/path/to/dory-to-dory-mcp/dist/cli.js"],
+      "env": {
+        "D2D_CORE_URL": "http://127.0.0.1:8000",
+        "D2D_API_KEY": "d2d_test_replace_me"
+      }
+    }
+  }
+}
+```
+
+또는 `pnpm pack`으로 생성한 `.tgz` 파일을 다른 장비에 전달해 설치할 수 있습니다.
+
+```sh
+npm install --global ./dory-to-dory-mcp-0.1.0.tgz
+```
+
+이후 MCP command를 `d2d-mcp`로 설정합니다.
+
+## 환경 변수
+
+| 이름 | 필수 | 기본값 | 설명 |
+|---|---:|---:|---|
+| `D2D_CORE_URL` | 예 | - | dory-to-dory Core base URL |
+| `D2D_API_KEY` | 예 | - | Core가 발급한 Agent API key |
+| `D2D_REQUEST_TIMEOUT_SECONDS` | 아니요 | `15` | HTTP 요청 timeout |
+| `D2D_MAX_RETRIES` | 아니요 | `2` | GET 및 idempotent 쓰기 요청의 추가 재시도 횟수 |
+
+API key는 tool input이나 stdout에 노출하지 않습니다. MCP 설정 파일의 권한을 제한하고, 유출 가능성이 있으면 Core 대시보드에서 즉시 키를 재발급하십시오.
+
+## 개발 및 검증
+
+```sh
+pnpm run check
+pnpm run inspect
+```
+
+Core OpenAPI가 변경되면 snapshot과 타입을 갱신합니다.
+
+```sh
+pnpm run sync:core-contract -- /absolute/path/to/dory-to-dory-core/contracts/openapi.json
+pnpm run generate
+pnpm run check
+```
+
+배포 선택지와 운영상 제약은 [docs/deployment.md](docs/deployment.md)를 참고하십시오.