esa MCP 서버

이것을 일본어 로 읽어보세요

개요

이 서버는 Claude AI가 esa API 와 상호 작용할 수 있도록 MCP(Model Context Protocol)를 사용하는 인터페이스입니다.

이 MCP 서버를 사용하여 Claude AI는 ESA 문서 검색, 생성, 업데이트 등의 작업을 수행할 수 있습니다.

저장소 정보

이 저장소는 ESA MCP 서버의 독립형 구현을 제공합니다. Claude AI와 ESA를 통합하여 문서 관리를 간소화합니다.

설정

필수 조건

Node.js 18 이상
esa API 액세스 토큰
esa 팀 이름

설치

지엑스피1

환경 변수 설정

# Set environment variables
export ESA_ACCESS_TOKEN="your_esa_access_token"
export ESA_TEAM="your_team_name"

MCP 구성 예

이 MCP 서버를 사용하는 경우 mcp_config.json 파일에 다음 구성을 추가하세요.

"esa": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/esa-mcp-server"],
  "env": {
    "ESA_ACCESS_TOKEN": "your_esa_access_token",
    "ESA_TEAM": "your_team_name"
  }
}

서버 시작

# Start the server
npm start

사용 가능한 도구

이 MCP 서버는 다음과 같은 도구를 제공합니다.

댓글 관련

esa_list_comments
- 게시물에 대한 댓글 목록 가져오기
- 입력:
  - post_number (숫자, 필수): 댓글을 받을 게시물 번호
  - page (번호, 선택 사항): 검색할 페이지 번호
  - per_page (숫자, 선택 사항): 페이지당 결과 수(최대: 100)
esa_get_comment
- 구체적인 의견을 받다
- 입력:
  - comment_id (숫자, 필수): 검색할 댓글의 ID
  - include (문자열, 선택 사항): 응답에 포함할 관련 데이터(예: 'stargazers')
esa_create_comment
- 기사에 댓글을 달아주세요
- 입력:
  - post_number (숫자, 필수): 댓글을 달 게시물 번호
  - body_md (문자열, 필수): 주석 본문(마크다운 형식)
  - user (문자열, 선택 사항): 포스터의 화면 이름(팀 소유자만 지정할 수 있음)

회원 관련

esa_get_members
- 팀원 목록을 받으세요
- 입력:
  - page (번호, 선택 사항): 검색할 페이지 번호
  - per_page (숫자, 선택 사항): 페이지당 결과 수(최대: 100)
esa_get_member
- 특정 팀원에 대한 정보를 얻으세요
- 입력:
  - screen_name_or_email (문자열, 필수): 검색할 멤버의 화면 이름 또는 이메일

사용 예

다음은 Claude가 MCP 서버를 사용하여 ESA 게시물을 만드는 예입니다.

[Claude] Please create a new post in esa. The title should be "Project X Progress Report" and the body should include "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C".

[MCP Server] Using the esa_create_post tool to create a new post.

[Result]
{
  "number": 123,
  "name": "Project X Progress Report",
  "body_md": "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C",
  "wip": false,
  "created_at": "2023-06-01T12:34:56+09:00",
  "updated_at": "2023-06-01T12:34:56+09:00",
  "url": "https://your-team.esa.io/posts/123"
}

[Claude] The post has been created successfully. The post number is 123, and you can access it at the following URL:
https://your-team.esa.io/posts/123

문제 해결

액세스 토큰 문제

Error: Request failed with status code 401

이 오류가 표시되면 ESA 액세스 토큰이 유효하지 않거나 만료되었을 수 있습니다. ESA 설정 화면에서 새 액세스 토큰을 생성하고 환경 변수를 업데이트하세요.

권한 문제

Error: Request failed with status code 403

이 오류가 표시되면 현재 액세스 토큰에 필요한 권한이 없는 것입니다. ESA 설정 화면에서 액세스 토큰의 권한을 확인하고 필요한 경우 새 토큰을 발급하세요.

특허

MIT 라이선스에 따라 제공됩니다.

esa MCP Server