허니컴-mcp-서버

허니컴 MCP 서버

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

개요

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

이 MCP 서버를 사용하면 Claude AI는 Honeycomb 데이터 세트, 쿼리, 이벤트, 보드, 마커, SLO 및 트리거를 검색, 생성 및 업데이트하는 등의 작업을 수행할 수 있습니다.

저장소 정보

이 저장소는 Honeycomb MCP 서버의 독립형 구현을 제공합니다. Claude AI와 Honeycomb을 통합하여 관찰 및 모니터링 워크플로를 간소화합니다.

설정

필수 조건

Node.js 18 이상
허니컴 API 키

설치

지엑스피1

환경 변수 설정

# Set environment variables
export HONEYCOMB_API_KEY="your_honeycomb_api_key"

MCP 구성 예

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

"honeycomb": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/honeycomb-mcp-server"],
  "env": {
    "HONEYCOMB_API_KEY": "your_honeycomb_api_key"
  }
}

서버 시작

# Start the server
npm start

사용 가능한 도구

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

입증

honeycomb_auth
- Honeycomb API로 인증합니다
- 입력:
  - apiKey (문자열, 선택 사항): Honeycomb API 키(제공되지 않으면 환경 변수 사용)

데이터 세트 관리

honeycomb_datasets_list
- 사용 가능한 모든 데이터 세트를 나열합니다.
- 입력 매개변수가 필요하지 않습니다
honeycomb_dataset_get
- 특정 데이터 세트에 대한 정보를 가져옵니다
- 입력:
  - datasetSlug (문자열, 필수): 데이터 세트의 슬러그
honeycomb_datasets_create
- 새로운 데이터 세트를 생성합니다
- 입력:
  - name (문자열, 필수): 데이터 세트의 이름
  - description (문자열, 선택 사항): 데이터 세트에 대한 설명

열 관리

honeycomb_columns_list
- 데이터 세트의 모든 열을 나열합니다
- 입력:
  - datasetSlug (문자열, 필수): 데이터 세트의 슬러그

쿼리 관리

honeycomb_query_create
- 데이터 세트에 대한 새 쿼리를 생성합니다.
- 입력:
  - datasetSlug (문자열, 필수): 데이터 세트의 슬러그
  - query (객체, 필수): 쿼리 구성
honeycomb_query_result_create
- 쿼리를 실행하고 결과를 반환합니다.
- 입력:
  - datasetSlug (문자열, 필수): 데이터 세트의 슬러그
  - query (객체, 필수): 쿼리 구성

이벤트 관리

honeycomb_event_create
- 데이터 세트에 새 이벤트를 생성합니다.
- 입력:
  - datasetSlug (문자열, 필수): 데이터 세트의 슬러그
  - data (객체, 필수): 이벤트 데이터

이사회 관리

honeycomb_boards_list
- 모든 보드를 나열합니다
- 입력 매개변수가 필요하지 않습니다
honeycomb_board_get
- 특정 보드에 대한 정보를 얻습니다
- 입력:
  - boardId (문자열, 필수): 보드의 ID
honeycomb_board_create
- 새로운 보드를 만듭니다
- 입력:
  - name (문자열, 필수): 보드 이름
  - description (문자열, 선택 사항): 보드에 대한 설명
  - query_ids (문자열 배열, 선택 사항): 보드에 포함할 쿼리 ID
honeycomb_board_update
- 기존 보드를 업데이트합니다
- 입력:
  - boardId (문자열, 필수): 업데이트할 보드의 ID
  - name (문자열, 선택 사항): 보드의 새 이름
  - description (문자열, 선택 사항): 보드에 대한 새 설명
  - query_ids (문자열 배열, 선택 사항): 보드에 포함할 새 쿼리 ID

마커 관리

honeycomb_markers_list
- 데이터 세트의 모든 마커를 나열합니다.
- 입력:
  - datasetSlug (문자열, 필수): 데이터 세트의 슬러그
honeycomb_marker_create
- 새로운 마커를 생성합니다
- 입력:
  - datasetSlug (문자열, 필수): 데이터 세트의 슬러그
  - message (문자열, 필수): 마커에 대한 메시지
  - type (문자열, 필수): 마커의 유형
  - start_time (문자열, 필수): 마커의 시작 시간
  - end_time (문자열, 선택 사항): 마커의 종료 시간
  - url (문자열, 선택 사항): 마커와 연결된 URL
- 입력:
  - datasetSlug (문자열, 필수): 데이터 세트의 슬러그
  - markerId (문자열, 필수): 삭제할 마커의 ID

사용 예

다음은 Claude가 MCP 서버를 사용하여 새로운 Honeycomb 데이터 세트를 만들고 이벤트를 추가하는 예입니다.

[Claude] Please create a new dataset in Honeycomb called "Application Monitoring" with a description "Monitoring for our production application".

[User] I'll help you create a new dataset in Honeycomb.

[Claude] I'll create a new dataset for you in Honeycomb. 

I'll use the honeycomb_datasets_create tool:

Input:
{
  "name": "Application Monitoring",
  "description": "Monitoring for our production application"
}

The dataset has been created successfully!

[Claude] Now, let me add an event to this dataset. I'll create an event with some sample metrics.

I'll use the honeycomb_event_create tool:

Input:
{
  "datasetSlug": "application-monitoring",
  "data": {
    "service": "api-gateway",
    "duration_ms": 45.2,
    "status_code": 200,
    "endpoint": "/users",
    "method": "GET"
  }
}

Event created successfully! You can now see this event in the Honeycomb UI under the Application Monitoring dataset.

[Claude] I can also create a query to analyze this data. Let me create a query that shows the average duration by endpoint.

I'll use the honeycomb_query_create tool:

Input:
{
  "datasetSlug": "application-monitoring",
  "query": {
    "calculations": [
      {
        "op": "AVG",
        "column": "duration_ms"
      }
    ],
    "breakdowns": ["endpoint"],
    "time_range": 3600
  }
}

일반적인 통합 패턴

관찰성 자동화
[User] Claude, please help me set up a new SLO for API response times. [Claude] I can help with that. Let me create an SLO to track API response times. I'll use honeycomb_slo_create with these parameters: { "datasetSlug": "production-api", "name": "API Response Time SLO", "description": "Tracks response time for critical API endpoints", "sli": { "alias": "Response Time < 300ms", "conditions": { "column": "duration_ms", "operator": "<", "value": 300 } }, "time_period_days": 30, "target_per_million": 995000 }
사건 조사
[User] We're seeing elevated error rates in production. Can you help investigate? [Claude] I'll help investigate the elevated error rates. Let me query the recent error data. First, I'll use honeycomb_query_result_create: { "datasetSlug": "production", "query": { "calculations": [ { "op": "COUNT" } ], "filters": [ { "column": "status_code", "operator": ">=", "value": 500 } ], "breakdowns": ["service", "endpoint"], "time_range": 3600, "granularity": 60 } }

"프로덕션 애플리케이션 모니터링"이라는 설명으로 "애플리케이션 모니터링" 데이터 세트를 생성합니다...

[클로드는 honeycomb_datasets_create를 사용합니다]

데이터세트가 성공적으로 생성되었습니다! 이제 이벤트를 추가할 수 있습니다.

테스트하기 위해 데이터 세트에서 샘플 이벤트를 생성할까요?

[사용자] 네, 샘플 이벤트를 추가해 주세요.

[클로드] "애플리케이션 모니터링" 데이터 세트에 샘플 이벤트를 추가하겠습니다.

[클로드는 honeycomb_event_create를 사용합니다]

성공! "애플리케이션 모니터링" 데이터세트에 다음 데이터를 사용하여 샘플 이벤트를 추가했습니다. { "service": "api-server", "message": "사용자 로그인 성공", "duration_ms": 45, "status_code": 200, "endpoint": "/api/login", "timestamp": "2025-03-25T14:30:00Z" }

이 이벤트는 완료하는 데 45ms가 걸린 성공적인 사용자 로그인 작업을 나타냅니다.

이제 Honeycomb 대시보드에서 이 이벤트를 보고 데이터 분석을 위한 쿼리를 작성할 수 있습니다.

## Error Handling

This MCP server returns error information in a consistent format. When an error occurs, the following structure is returned:

```json
{
  "error": {
    "message": "Detailed error description",
    "code": "ERROR_CODE"
  }
}

일반적인 오류 코드

AUTH_ERROR : 인증에 실패했습니다. API 키를 확인하세요.
NOT_FOUND : 요청한 리소스를 찾을 수 없습니다.
INVALID_PARAMETER : 하나 이상의 매개변수가 잘못되었습니다.
RATE_LIMIT : Honeycomb API 속도 제한에 도달했습니다.
SERVER_ERROR : 내부 서버 오류가 발생했습니다.

문제 해결 팁

인증 문제
- HONEYCOMB_API_KEY 가 올바르게 설정되었는지 확인하세요.
- API 키에 적절한 권한이 있는지 확인하세요.
데이터 세트를 찾을 수 없습니다
- 데이터 세트 슬러그가 올바른지 확인하세요(오타가 있는지 확인하세요)
- Honeycomb 계정에 데이터 세트가 있는지 확인하세요.
쿼리 실행 문제
- 쿼리 매개변수가 올바르게 형식화되었는지 확인합니다.
- 쿼리의 열 이름이 데이터 세트의 열 이름과 일치하는지 확인하세요.

기여하다

Honeycomb MCP 서버에 기여해 주세요! 기여 방법은 다음과 같습니다.

개발 설정

저장소를 포크하세요
포크를 복제하세요
git clone https://github.com/your-username/honeycomb-mcp-server.git
종속성 설치
npm install
변경 사항을 만드세요
빌드를 실행하세요
npm run build
변경 사항을 로컬에서 테스트하세요

풀 리퀘스트 프로세스

기능 브랜치 생성
git checkout -b feat-your-feature-name
기존 커밋 형식에 따라 변경 사항을 커밋하세요.
git commit -m "feat: add new feature"
포크로 밀어주세요
git push origin feat-your-feature-name
풀 리퀘스트 열기

코딩 표준

모든 새 코드에 TypeScript를 사용하세요
기존 코드 스타일을 따르세요
공개 API에 대한 주석 추가
새로운 기능에 대한 테스트를 작성하세요

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

honeycomb-mcp-server