Blog-Api-Server on Yarang's Tech Lair

[blog-api-server] MCP 블로그 클라이언트 언어 파라미터 추가

Tue, 03 Mar 2026 23:19:28 +0900

[blog-api-server] MCP 블로그 클라이언트 언어 파라미터 추가

개요

MCP (Model Context Protocol) 블로그 클라이언트에 언어 파라미터를 추가하여 한국어/영어 다국어 블로그 관리를 개선했습니다.

변경 사항

blog_create 도구 업�데이트

Tool(
 name="blog_create",
 description="블로그 포스트 생성. 제목과 내용(Markdown)을 입력하면 포스트가 생성되고 Git에 커밋/푸시됩니다.",
 inputSchema={
 "type": "object",
 "properties": {
 "title": {"type": "string", "description": "포스트 제목"},
 "content": {"type": "string", "description": "포스트 내용 (Markdown)"},
 "tags": {"type": "array", "items": {"type": "string"}, "description": "태그 목록"},
 "categories": {"type": "array", "items": {"type": "string"}, "description": "카테고리 목록"},
 "draft": {"type": "boolean", "description": "초안 여부 (기본값: false)"},
 "language": {"type": "string", "description": "언어 (ko, en). 기본값: ko"} # 신규
 },
 "required": ["title", "content"]
 }
)

API 호출 로직

if name == "blog_create":
 result = await client.request("POST", "/posts", data={
 "title": arguments["title"],
 "content": arguments["content"],
 "tags": arguments.get("tags", []),
 "categories": arguments.get("categories", ["Development"]),
 "draft": arguments.get("draft", False),
 "language": arguments.get("language", "ko"), # 기본값: 한국어
 "auto_push": True
 })

사용 방법

Claude Code에서 사용

{
 "mcpServers": {
 "blog": {
 "command": "python3",
 "args": ["/path/to/mcp_blog_client.py"],
 "env": {
 "BLOG_API_URL": "https://blog.fcoinfup.com",
 "BLOG_API_KEY": "your_api_key"
 }
 }
 }
}

한국어 포스트 작성

{
 "tool": "blog_create",
 "arguments": {
 "title": "[프로젝트명] 포스트 제목",
 "content": "# 내용\n\n마크다운 형식의 내용...",
 "tags": ["tag1", "tag2"],
 "categories": ["Development"],
 "language": "ko"
 }
}

영어 포스트 작성

{
 "tool": "blog_create",
 "arguments": {
 "title": "[Project Name] Post Title",
 "content": "# Content\n\nMarkdown formatted content...",
 "tags": ["tag1", "tag2"],
 "categories": ["Development"],
 "language": "en"
 }
}

API 예시

요청 형식

curl -X POST https://blog.fcoinfup.com/api/posts \
 -H "X-API-Key: your_api_key" \
 -H "Content-Type: application/json" \
 -d '{
 "title": "[blog-api-server] Test Post",
 "content": "# Test\n\nThis is a test post.",
 "tags": ["test"],
 "categories": ["Development"],
 "language": "en",
 "auto_push": true
 }'

응답 형식

{
 "success": true,
 "filename": "2026-03-03-001-blog-api-server-test-post.md",
 "path": "/content/en/post/2026-03-03-001-blog-api-server-test-post.md",
 "git": {
 "success": true,
 "commit": "abc123...",
 "branch": "main"
 }
}

파일 경로 규칙

언어	language 값	저장 경로
한국어	`ko`	`content/ko/post/`
영어	`en`	`content/en/post/`

향후 계획

번역 자동화: 언어 파라미터를 활용한 자동 번역 기능
i18n 링크: KO/EN 포스트 간 자동 연결 생성
다국어 지원 확장: 일본어, 중국어 등 추가 언어 지원

결론

MCP 블로그 클라이언트에 언어 파라미터를 추가하여 Claude Code에서 더 편리하게 다국어 블로그를 관리할 수 있게 되었습니다.

영어 버전: English Version

[blog-api-server] 모니터링 대시보드 및 알림 시스템 구축

Tue, 03 Mar 2026 14:53:47 +0900

[blog-api-server] 모니터링 대시보드 및 알림 시스템 구축

개요

blog-api-server에 프로메테우스 기반 모니터링 시스템과 Slack/Email 알림 기능을 추가하여 서버 상태를 실시간으로 추적하고 문제 발생 시 즉시 대응할 수 있게 되었습니다.

모니터링 아키텍처

flowchart TB
 A[HTTP Request] --> B[MonitoringMiddleware]
 B --> C[Request Logging]
 B --> D[PrometheusMiddleware]
 D --> E[Metrics Collection]
 C --> F[AlertManager]
 E --> F
 F --> G{Threshold Check}
 G -->|Over Threshold| H[Slack Webhook]
 G -->|Critical| I[Email Alert]
 G -->|Normal| J[Log Only]
 K[Prometheus Server] --> L[/metrics/prometheus]
 M[Dashboard] --> N[/dashboard]

Prometheus 메트릭

기본 HTTP 메트릭

메트릭명	타입	라벨	설명
`http_requests_total`	Counter	method, endpoint, status	총 HTTP 요청 수
`http_request_duration_seconds`	Histogram	method, endpoint	요청 처리 시간 분포
`http_errors_total`	Counter	method, endpoint, status	총 에러 수
`active_requests`	Gauge	-	현재 활성 요청 수

비즈니스 메트릭

메트릭명	타입	라벨	설명
`git_operations_total`	Counter	operation, status	Git 작업 수
`git_operation_duration_seconds`	Histogram	operation	Git 작업 소요 시간
`translation_requests_total`	Counter	source_lang, target_lang, status	번역 요청 수
`translation_duration_seconds`	Histogram	-	번역 소요 시간
`post_operations_total`	Counter	operation, language, status	포스트 작업 수

메트릭 수집 코드

# prometheus_exporter.py
from prometheus_client import Counter, Histogram, Gauge

http_requests_total = Counter(
 'http_requests_total',
 'Total HTTP requests',
 ['method', 'endpoint', 'status']
)

http_request_duration_seconds = Histogram(
 'http_request_duration_seconds',
 'HTTP request latency',
 ['method', 'endpoint']
)

# 미들웨어에서 자동 수집
class PrometheusMiddleware(BaseHTTPMiddleware):
 async def dispatch(self, request: Request, call_next):
 start_time = time.time()
 response = await call_next(request)
 duration = time.time() - start_time

 http_requests_total.labels(
 method=request.method,
 endpoint=request.url.path,
 status=response.status_code
 ).inc()

 http_request_duration_seconds.labels(
 method=request.method,
 endpoint=request.url.path
 ).observe(duration)

알림 시스템

알림 규칙

규칙명	조건	심각도	쿨다운
High Error Rate	error_rate > 5%	WARNING	5분
Critical Error Rate	error_rate > 20%	CRITICAL	1분
Slow Response Time	avg_response_time > 2000ms	WARNING	10분
High Slow Request Rate	slow_request_rate > 10%	WARNING	5분

알림 채널

Slack Webhook

모든 심각도 수준 지원
색상으로 심각도 표현 (INFO: 녹색, WARNING: 주황, ERROR: 빨강, CRITICAL: 짙은 빨강)

Email

CRITICAL 수준만 전송
SMTP 기반 이메일 발송

AlertManager 코드

# alerting.py
class AlertManager:
 def check_and_alert(self, metrics: Dict[str, Any]):
 for rule in self.rules:
 if rule.should_trigger(metrics):
 self._send_alert(rule, metrics)

 def _send_alert(self, rule: AlertRule, metrics: Dict[str, Any]):
 message = f"""
Alert Rule: {rule.name}
Condition: {rule.condition}

Current Metrics:
- Total Requests: {metrics.get('total_requests', 0)}
- Error Count: {metrics.get('error_count', 0)}
- Error Rate: {metrics.get('error_rate_percent', 0)}%
- Slow Requests: {metrics.get('slow_request_count', 0)}
"""
 self.slack.send(
 title=f"Alert: {rule.name}",
 message=message.strip(),
 severity=rule.severity
 )

대시보드 구성

모니터링 엔드포인트

경로	인증	설명
`/health`	불필요	서버 상태 확인
`/metrics`	필요	JSON 형식 메트릭
`/metrics/prometheus`	불필요	Prometheus 형식 메트릭
`/metrics/reset`	필요	메트릭 초기화
`/dashboard`	불필요	웹 대시보드
`/alerts/rules`	필요	알림 규칙 목록
`/alerts/send`	필요	수동 알림 전송

요청 추적 미들웨어

# middleware.py
class MonitoringMiddleware(BaseHTTPMiddleware):
 async def dispatch(self, request: Request, call_next):
 request_id = str(uuid.uuid4())
 start_time = time.time()

 response = await call_next(request)
 process_time = (time.time() - start_time) * 1000

 # 응답 헤더에 추적 정보 추가
 response.headers["X-Process-Time"] = f"{process_time:.2f}"
 response.headers["X-Request-ID"] = request_id

 return response

환경 변수 설정

# Slack 알림
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...

# Email 알림
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your-email@gmail.com
SMTP_PASSWORD=your-app-password
ALERT_FROM_EMAIL=your-email@gmail.com
ALERT_TO_EMAILS=admin@example.com,ops@example.com

# 임계값 설정
SLOW_REQUEST_THRESHOLD=1000 # 1초
VERY_SLOW_THRESHOLD=3000 # 3초
MAX_BODY_LOG_LENGTH=1000

향후 계획

Grafana 통합: Prometheus 데이터를 Grafana 대시보드로 시각화
알림 규칙 동적 구성: 런타임에 알림 규칙 추가/제거 API
메트릭 보관: 장기 메트릭 데이터 저장 및 분석
Health Check 강화: 의존 서비스(Git, LLM) 상태 확인

결론

프로메테우스 기반 모니터링과 Slack/Email 알림 시스템을 통해 서버 상태를 실시간으로 모니터링하고 문제 발생 시 즉시 대응할 수 있는 인프라가 구축되었습니다.

영어 버전: English Version

[blog-api-server] LLM 설정 개선 및 배포

Tue, 03 Mar 2026 13:01:48 +0900

개요

blog-api-server 프로젝트의 LLM 설정을 개선하고 서버에 배포했다.

LLM 설정 개선

기존 문제

여러 개의 API Key 환경 변수 (ZAI_API_KEY, ANTHROPIC_API_KEY)
Provider 분기 로직이 복잡함
모델 설정이 분산되어 있음

변경 사항

환경 변수 단순화

# 기존
ZAI_API_KEY=xxx
ANTHROPIC_API_KEY=xxx
ZAI_MODEL=gpt-4o-mini
LLM=ZAI

# 변경 후
LLM=ZAI # Provider (ZAI, OPENAI, ANTHROPIC)
LLM_API_KEY=xxx # 단일 API Key
LLM_MODEL=glm-4.7 # 기본 모델
LLM_TIMEOUT=120 # 타임아웃 (초)

BASE_URL 자동 설정

LLM_BASE_URLS = {
 "ZAI": "https://api.z.ai/api/coding/paas/v4",
 "OPENAI": "https://api.openai.com/v1",
 "ANTHROPIC": "https://api.anthropic.com/v1"
}

코드 구조 개선

class Translator:
 """LLM 기반 번역기"""
 
 def __init__(self):
 self.api_key = LLM_API_KEY
 self.base_url = LLM_BASE_URL # 자동 선택
 self.model = LLM_MODEL
 self.timeout = LLM_TIMEOUT

모델 설정

기본 모델

glm-4.7 (기본값)
max_tokens: 8192

지원 모델

모델	max_tokens
glm-4	8192
glm-4.7	8192
gpt-4o-mini	4096
gpt-4o	8192
claude-3-5-haiku	8192

팀 구성

blog-api-server 개발 팀을 구성했다.

역할	이름	담당
팀 리드	team-lead	전체 관리
개발자	developer	코드 작성, 기능 구현
배포 관리자	deployer	서버 배포, 인프라
모니터링	monitor	로그 분석, 성능 모니터링

서버 배포

배포 대상

서버: blog.fcoinfup.com (130.162.133.47)
경로: /var/www/blog-api

배포 내용

translator.py 업데이트
systemd 서비스 재시작

배포 결과

● blog-api.service - Blog API Server
 Active: active (running)

다음 단계

번역 API 테스트
모니터링 대시보드 구축
로그 파일 롤오버 정책 적용

영어 버전: English Version