블로거-mcp-서버

=======

Blogger용 MCP 서버

Claude와 같은 인공지능 모델이 Google의 Blogger API와 직접 상호 작용할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

에 대한

이 프로젝트는 Google의 Blogger API를 위한 MCP(Model Context Protocol) 호환 서버를 구현합니다. 이를 통해 Claude와 같은 AI 모델은 Blogger 블로그와 상호 작용하여 다음을 수행할 수 있습니다.

• 블로그 목록 및 검색

• 게시물 나열, 검색, 검색, 생성, 업데이트 및 삭제

• 레이블 나열 및 검색

중요 참고 사항 : Google의 Blogger API를 사용하면 API를 통해 새로운 블로그를 만들 수 없습니다. 이러한 제한 사항은 Google에서 문서화되어 있습니다. 블로그는 Blogger 웹 인터페이스를 통해 수동으로 만들어야 합니다.

Related MCP server: Blogger MCP Server

필수 조건

• Node.js(버전 16 이상)

• Google Blogger API 키

시설

npm에서 설치

지엑스피1

소스 코드에서 설치

git clone https://github.com/niyonabil/blogger-mcp-server.git
cd blogger-mcp-server
npm install
npm run build

오류가 발생하면 설치하세요:

npm install --save-dev @types/express @types/socket.io

구성

Blogger API 키 받기

1. Google Cloud Console 에 액세스하세요

2. 새 프로젝트를 생성하거나 기존 프로젝트를 선택하세요

3. Blogger API v3 활성화

4. API 키 생성

5. 구성에 사용할 이 키를 기록해 두십시오.

MCP 서버 구성

MCP 클라이언트에 대한 구성 파일을 만듭니다. 다음은 Claude Desktop의 예입니다.

{
  "mcpServers": {
    "blogger": {
      "command": "npx",
      "args": [
        "-y",
        "@mcproadev/blogger-mcp-server"
      ],
      "env": {
        "BLOGGER_API_KEY": "VOTRE_CLE_API_ICI"
      }
    }
  }
}

VOTRE_CLE_API_ICI 귀하가 얻은 API 키로 바꾸세요.

사용

로컬 부팅

이 프로젝트에는 서버 시작을 용이하게 하는 두 개의 스크립트가 포함되어 있습니다.

개발 모드

export BLOGGER_API_KEY=votre_cle_api
./start-dev.sh

이 스크립트는 API 키가 있는지 확인하고, 필요한 경우 종속성을 설치하고, 필요한 경우 프로젝트를 컴파일한 다음 개발 모드에서 서버를 시작합니다.

생산 모드

export BLOGGER_API_KEY=votre_cle_api
npm run build
./start-prod.sh

이 스크립트는 API 키가 있는지, 프로젝트가 컴파일되었는지 확인한 다음, 서버를 프로덕션 모드로 시작합니다.

MCP 클라이언트와 함께 사용

구성이 완료되면 Claude Desktop 등 호환되는 모든 MCP 클라이언트와 함께 Blogger용 MCP 서버를 사용할 수 있습니다.

명령어의 예:

• "내 모든 Blogger 블로그 나열"

• "내 블로그에 ID 123456, 제목 '내 새 게시물', 내용 '내 게시물 내용은 다음과 같습니다'로 새 게시물을 작성하세요."

• "내 블로그에서 '기술'이라는 단어가 포함된 게시물을 검색하세요"

• "ID 789012의 게시물을 업데이트하여 제목을 '새 제목'으로 변경하세요."

배포 옵션

Vercel에 배포

이 프로젝트에는 Vercel에 배포하기 쉽게 해주는 vercel.json 파일이 포함되어 있습니다.

1. Vercel 에 계정이 없으시다면 계정을 만드세요.

2. Vercel CLI 도구를 설치하세요: npm install -g vercel

3. Vercel 계정에 로그인하세요: vercel login

4. 비밀 환경 변수를 구성하세요: vercel secrets add blogger_api_key "VOTRE_CLE_API_ICI"

5. 프로젝트 배포: vercel

Docker를 사용한 배포

이 프로젝트에는 Docker 컨테이너에 배포하기 쉽게 해주는 Dockerfile이 포함되어 있습니다.

1. Docker 이미지를 빌드합니다.

   docker build -t blogger-mcp-server .

2. 컨테이너를 실행합니다.

   docker run -p 3000:3000 -e BLOGGER_API_KEY=votre_cle_api blogger-mcp-server

기타 배포 옵션

서버는 다른 Node.js 호환 플랫폼에도 배포할 수 있습니다.

1. Heroku : Procfile과 Heroku 환경 변수 사용

2. AWS Lambda : 어댑터를 서버리스 프레임워크로 사용

3. Google Cloud Run : 포함된 Dockerfile을 사용하세요

프로젝트 구조

Blogger용 MCP 서버는 여러 모듈로 구성됩니다.

• index.ts : 메인 진입점

• server.ts : MCP 서버 구성

• bloggerService.ts : Blogger API와 상호 작용하기 위한 서비스

• config.ts : 서버 설정

• types.ts : 유형 및 인터페이스 정의

• mcp-sdk-mock.ts : 종속성 문제를 피하기 위한 MCP SDK의 단순화된 구현

알려진 제한 사항

• 블로그 만들기 : Google의 Blogger API는 API를 통해 새로운 블로그를 만드는 것을 허용하지 않습니다. 블로그는 Blogger 웹 인터페이스를 통해 수동으로 만들어야 합니다.

• 게시물 검색 : Blogger API는 검색을 위한 직접적인 엔드포인트를 제공하지 않습니다. 이 기능은 게시물을 가져온 다음 필터링하는 방식으로 클라이언트 측에서 구현됩니다.

• 라벨 관리 : Blogger API는 라벨 관리를 위한 직접적인 엔드포인트를 제공하지 않습니다. 이 기능은 게시물에서 라벨을 추출하여 구현됩니다.

• 인증 : 이 서버는 API 키 인증만 사용하며, 이는 공개 블로그나 명시적으로 액세스를 구성한 블로그에만 액세스를 제한합니다.

기부금

기여를 환영합니다! 자유롭게 이슈를 공개하거나 요청을 제출해 주시기 바랍니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

cf72ca4 (새로운 기능 추가)