Beehiiv MCP 서버

Beehiiv API v2와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 대규모 언어 모델(LLM)이 표준화된 도구를 통해 Beehiiv 출판물 및 게시물과 상호 작용할 수 있습니다.

필수 조건

• Python 3.10 이상

• uv 패키지 관리자

• API 액세스가 가능한 Beehiiv 계정

• Claude Desktop(또는 다른 MCP 호환 클라이언트)

Related MCP server: MCP Python Server — API Wrapper

설치

1. 아직 uv 설치하지 않았다면 설치하세요:

지엑스피1

2. 처음부터 다시 빌드하는 경우 프로젝트를 만들고 설정하세요.

# Create a new directory and navigate into it
mkdir beehiiv-mcp-server
cd beehiiv-mcp-server

# Create virtual environment and activate it
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx python-dotenv

3. 프로젝트 루트에 .env 파일을 만듭니다.

BEEHIIV_API_KEY=your_api_key_here
BEEHIIV_PUBLICATION_ID=your_publication_id_here

클로드 데스크톱 구성

Claude Desktop 구성 파일( ~/Library/Application Support/Claude/claude_desktop_config.json )에 다음을 추가합니다.

{
  "mcpServers": {
    "beehiiv-mcp-server": {
      "command": "<ABSOLUTE_UV_PATH>",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<ABSOLUTE_SERVER_PATH>"
      ]
    }
  }
}

바꾸다:

• <ABSOLUTE_UV_PATH> 에 uv 실행 파일의 경로를 추가합니다.

• <ABSOLUTE_SERVER_PATH>``beehiiv_server.py 파일의 절대 경로를 입력합니다.

사용 가능한 도구

이 MCP 서버는 현재 다음 도구를 제공합니다(더 많은 도구가 추가될 예정입니다).

출판물 목록

API 키로 접근할 수 있는 모든 출판물을 나열합니다.

게시물 목록

해당 출판물에 대해 가장 최근에 확인된 게시물 5개를 나열합니다.

list_posts(publication_id: str)

get_post

특정 게시물에 대한 자세한 정보를 검색합니다.

get_post(publication_id: str, post_id: str)

게시물_내용_가져오기

게시물의 전체 HTML 콘텐츠를 검색합니다.

새 게시물 만들기

beehiiv 플랫폼에 새 게시물을 작성합니다(Enterprise 전용)

작동 원리

Claude Desktop을 통해 이 서버와 상호 작용하는 경우:

1. 클라이언트가 귀하의 질문을 Claude에게 보냅니다.

2. Claude는 사용 가능한 Beehiiv 도구를 분석하고 어떤 도구를 사용할지 결정합니다.

3. 클라이언트는 이 MCP 서버를 통해 선택한 도구를 실행합니다.

4. 결과는 Claude에게 다시 전송됩니다.

5. Claude는 자연어 응답을 공식화합니다.

6. 응답이 표시됩니다

(곧 영상이 공개됩니다)

문제 해결

Claude에 서버가 표시되지 않음

1. claude_desktop_config.json 파일 구문을 확인하세요.

2. 모든 경로가 상대 경로가 아닌 절대 경로인지 확인하세요.

3. Claude Desktop을 다시 시작하세요

로그 보기

MCP 관련 문제에 대한 Claude의 로그를 확인하세요.

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

로그는 다음 위치에 저장됩니다.

• 일반 MCP 연결의 경우 ~/Library/Logs/Claude/mcp.log

• 서버별 로그의 경우 ~/Library/Logs/Claude/mcp-server-beehiiv-mcp-server.log

보안

• .env 파일을 버전 제어에 커밋하지 마십시오.

• Beehiiv API 키를 안전하게 보관하세요

• API 호출에 대한 속도 제한 구현을 고려하세요

기여하다

X의 hmu ( https://x.com/reymerekar7 )