Skip to main content
Glama

esa MCP 서버

이것을

개요

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

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

Related MCP server: MCP Expert Server

저장소 정보

이 저장소는 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 서버는 다음과 같은 도구를 제공합니다.

관련 게시물

  1. esa_list_posts

    • 팀의 게시물 목록을 가져옵니다

    • 입력:

      • q (문자열, 선택 사항): 검색 쿼리

      • include (문자열, 선택 사항): 응답에 포함할 관련 데이터(예: 'comments,stargazers')

      • sort (문자열, 선택 사항): 정렬 방법(업데이트됨, 생성됨, 숫자, 별점, 시청, 댓글, 가장 잘 맞는 항목)

      • order (문자열, 선택 사항): 정렬 순서(desc, asc)

      • per_page (숫자, 선택 사항): 페이지당 결과 수(최대: 100)

      • page (번호, 선택 사항): 검색할 페이지 번호

  2. esa_get_post

    • 특정 게시물에 대한 자세한 정보를 얻으세요

    • 입력:

      • post_number (숫자, 필수): 검색할 게시물 번호

      • include (문자열, 선택 사항): 응답에 포함할 관련 데이터(예: 'comments,stargazers')

  3. esa_create_post

    • 새로운 게시물을 만드세요

    • 입력:

      • name (문자열, 필수): 게시물 제목

      • body_md (문자열, 선택 사항): 게시물 본문(마크다운 형식)

      • tags (문자열 배열, 선택 사항): 게시물에 대한 태그 목록

      • category (문자열, 선택 사항): 게시물 카테고리

      • wip (부울, 선택 사항, 기본값: true): WIP(진행 중인 작업)로 표시할지 여부

      • message (문자열, 선택 사항): 메시지 변경

      • user (문자열, 선택 사항): 포스터의 화면 이름(팀 소유자만 지정할 수 있음)

      • template_post_id (숫자, 선택 사항): 템플릿으로 사용할 게시물의 ID

  4. esa_update_post

    • 기존 게시물 업데이트

    • 입력:

      • post_number (숫자, 필수): 업데이트할 게시물 번호

      • name (문자열, 선택 사항): 게시물의 새 제목

      • body_md (문자열, 선택 사항): 게시물의 새 본문(마크다운 형식)

      • tags (문자열 배열, 선택 사항): 게시물에 대한 새 태그 목록

      • category (문자열, 선택 사항): 게시물의 새 카테고리

      • wip (부울, 선택 사항): WIP(진행 중인 작업)로 표시할지 여부

      • message (문자열, 선택 사항): 메시지 변경

      • created_by (문자열, 선택 사항): 포스터의 화면 이름(팀 소유자만 지정할 수 있음)

      • original_revision (문자열, 선택 사항): 업데이트의 기반이 되는 개정판

댓글 관련

  1. esa_list_comments

    • 게시물에 대한 댓글 목록 가져오기

    • 입력:

      • post_number (숫자, 필수): 댓글을 받을 게시물 번호

      • page (번호, 선택 사항): 검색할 페이지 번호

      • per_page (숫자, 선택 사항): 페이지당 결과 수(최대: 100)

  2. esa_get_comment

    • 구체적인 의견을 받다

    • 입력:

      • comment_id (숫자, 필수): 검색할 댓글의 ID

      • include (문자열, 선택 사항): 응답에 포함할 관련 데이터(예: 'stargazers')

  3. esa_create_comment

    • 기사에 댓글을 달아주세요

    • 입력:

      • post_number (숫자, 필수): 댓글을 달 게시물 번호

      • body_md (문자열, 필수): 주석 본문(마크다운 형식)

      • user (문자열, 선택 사항): 포스터의 화면 이름(팀 소유자만 지정할 수 있음)

회원 관련

  1. esa_get_members

    • 팀원 목록을 받으세요

    • 입력:

      • page (번호, 선택 사항): 검색할 페이지 번호

      • per_page (숫자, 선택 사항): 페이지당 결과 수(최대: 100)

  2. 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 라이선스에 따라 제공됩니다.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kajirita2002/esa-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server