affine-mcp-server

(★ 261)

Model Context Protocol server for AFFiNE. Connect AI assistants to AFFiNE workspaces, documents, databases, and collaboration APIs over stdio or HTTP.

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.yml
  - config.yml
  - feature_request.yml
- - pr-route-policy.cjs
- - ci.yml
  - docker.yml
  - e2e.yml
  - enforce-pr-base.yml
  - npm-publish.yml
- dependabot.yml
- pull_request_template.md
- affine-mcp
- .env.example
- docker-compose.yml
- - edgeless-canvas-demo-advanced-dark.png
  - edgeless-canvas-demo-advanced-light.png
- client-setup.md
- configuration-and-deployment.md
- edgeless-canvas-cookbook.md
- getting-started.md
- tool-reference.md
- workflow-recipes.md
- docs-drift-lib.mjs
- run-test-suite.mjs
- test-append-block-expansion.mjs
- test-suite-lib.mjs
- verify-docs.mjs
- verify-release.mjs
- verify-surface-element-gating.mjs
- verify-test-suites.mjs
- verify-tool-manifest.mjs
- - layout.ts
- - parse.ts
  - render.ts
  - richText.ts
  - safety.ts
  - types.ts
- - auth.ts
  - blobStorage.ts
  - comments.ts
  - docs.ts
  - history.ts
  - icons.ts
  - notifications.ts
  - organize.ts
  - properties.ts
  - user.ts
  - userCRUD.ts
  - workspaces.ts
- - explorerIcon.ts
  - inputSchemas.ts
  - mcp.ts
  - mutationSafety.ts
  - random.ts
- auth.ts
- authSession.ts
- cli.ts
- config.ts
- graphqlClient.ts
- httpAuth.ts
- httpDiagnostics.ts
- httpRuntimeConfig.ts
- index.ts
- networkSecurity.ts
- oauth.ts
- oauthServicePolicy.ts
- sse.ts
- toolOutputSchemas.ts
- toolSurface.ts
- urlSafety.ts
- ws.ts
- - playwright.config.ts
  - sign-in.ts
  - verify-data-view.pw.ts
  - verify-database.pw.ts
  - verify-edgeless-canvas.pw.ts
  - verify-tag-visibility.pw.ts
  - verify-theme-adaptation.pw.ts
- - comprehensive-result.mjs
- acquire-credentials.mjs
- assert-destructive-test-target.mjs
- configure-comprehensive-instance.mjs
- generate-test-env.sh
- live-test-safety.mjs
- require-destructive-test-safety.mjs
- run-comprehensive.sh
- run-e2e.sh
- test-auth-session.mjs
- test-blob-upload-contract.mjs
- test-canvas-tool-map-demo.mjs
- test-capabilities-fidelity.mjs
- test-cli-commands.mjs
- test-cli-live.mjs
- test-cli-version.mjs
- test-comprehensive-result.mjs
- test-config-cli-consistency.mjs
- test-create-doc-folder-placement.mjs
- test-create-placement.mjs
- test-data-view.mjs
- test-database-cells.mjs
- test-database-creation.mjs
- test-database-intent.mjs
- test-database-linked-doc.mjs
- test-database-schema.mjs
- test-database-ui-rows.mjs
- test-destructive-mutation-ack.mjs
- test-doc-discovery.mjs
- test-doc-properties.mjs
- test-docs-drift.mjs
- test-document-mutation-safety.mjs
- test-edgeless-canvas-cookbook.mjs
- test-edgeless-canvas-setup.mjs
- test-find-doc-by-title.mjs
- test-http-bearer.mjs
- test-http-email-password.mjs
- test-http-runtime-safety.mjs
- test-http-security.mjs
- test-icons.mjs
- test-input-contracts.mjs
- test-live-test-safety.mjs
- test-markdown-linked-page.mjs
- test-markdown-output-safety.mjs
- test-markdown-rich-text-import.mjs
- test-markdown-roundtrip.mjs
- test-mcp-result-contract.mjs
- test-native-template-instantiation.mjs
- test-notification-contract.mjs
- test-oauth-http.mjs
- test-oauth-service-policy.mjs
- test-organize-tools.mjs
- test-output-schemas.mjs
- test-package-smoke.mjs
- test-pr-route-policy.mjs
- test-read-doc-linked-refs.mjs
- test-release-verification.mjs
- test-secure-random.mjs
- test-semantic-page-composer.mjs
- test-stack-after-directions.mjs
- test-structured-receipts.mjs
- test-suites.json
- test-supporting-tools.mjs
- test-surface-elements.mjs
- test-tag-deletion.mjs
- test-tag-visibility.mjs
- test-test-suite-verifier.mjs
- test-theme-defaults-setup.mjs
- test-tool-filtering.mjs
- test-url-safety.mjs
- test-workspace-discovery.mjs
.coderabbit.yaml
.dockerignore
.editorconfig
.gitignore
.nvmrc
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
Dockerfile
glama.json
LICENSE
package-lock.json
package.json
README.md
RELEASE_NOTES.md
SECURITY.md
test-comprehensive.mjs
tool-manifest.json
tsconfig.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/DAWNCR0W/affine-mcp-server

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd affine-mcp-server

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다.

npm i -g affine-mcp-server

npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker run -d \

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

4. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm i -g affine-mcp-server

npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.

npm run ci

이 명령어를 터미널에 그대로 입력해 실행하세요.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm run build

배포용으로 코드를 최적화해서 빌드 파일을 생성합니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.