README.md•3.63 kB
# Text Analyzer MCP Server
AI 에이전트에서 답변 문자열의 글자 수를 체크하는 FastMCP 서버입니다.
## 기능
### 주요 도구 (Tools)
1. **count_characters(text, include_spaces)** - 글자 수 계산
- 전체 글자 수
- 공백 제외 글자 수
- 공백 개수
- 설정에 따른 최종 글자 수
2. **count_words(text)** - 단어 수 계산
- 총 단어 수
- 고유 단어 수
- 평균 단어 길이
3. **analyze_character_types(text)** - 문자 타입별 분석
- 알파벳, 숫자, 공백, 구두점
- 한글, 영어, 특수문자 분류
4. **get_text_statistics(text)** - 종합 통계 정보
- 문자, 단어, 줄, 문장 수
- 문자 타입별 분석
- 텍스트 미리보기
5. **check_text_length_limit(text, max_length)** - 길이 제한 검사
- 현재 길이와 제한 비교
- 초과/잔여 문자 수
- 사용률 백분율
### 리소스
- **text_analyzer://help** - 사용법 도움말
## 설치 및 실행
### 1. 환경 설정
```bash
# 가상환경 생성
python -m venv venv
# 가상환경 활성화
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate
# 의존성 설치
pip install -r requirements.txt
```
### 2. 서버 실행
#### 개발 모드 (권장)
```bash
# MCP Inspector와 함께 실행 (브라우저에서 테스트 가능)
fastmcp dev text_analyzer_server.py
```
#### 직접 실행
```bash
# Python으로 직접 실행
python text_analyzer_server.py
# 또는 FastMCP CLI 사용
fastmcp run text_analyzer_server.py
```
### 3. AI 클라이언트와 연결
#### Claude Desktop 설정
`claude_desktop_config.json` 파일에 다음을 추가:
```json
{
"mcpServers": {
"text_analyzer": {
"command": "python",
"args": ["/path/to/text_analyzer_server.py"]
}
}
}
```
#### VS Code/Cursor 설정
`.vscode/mcp.json` 또는 `.cursor/mcp.json` 파일 생성:
```json
{
"servers": {
"text_analyzer": {
"type": "stdio",
"command": "python",
"args": ["/path/to/text_analyzer_server.py"]
}
}
}
```
## 사용 예시
### 기본 글자 수 세기
```python
# AI 에이전트에서 사용 예시
# "안녕하세요 Hello World!"의 글자 수를 계산해주세요.
count_characters("안녕하세요 Hello World!", True)
# 결과:
# {
# "total_characters": 18,
# "characters_without_spaces": 16,
# "spaces_count": 2,
# "final_count": 18
# }
```
### 종합 텍스트 분석
```python
get_text_statistics("안녕하세요! 이것은 테스트 텍스트입니다.")
# 한글, 영어, 구두점 등 상세 분석 결과 제공
```
### 글자 수 제한 검사
```python
check_text_length_limit("분석할 텍스트", 100)
# 100자 제한에서 현재 사용량과 잔여량 확인
```
## 개발자 정보
이 MCP 서버는 FastMCP 프레임워크를 사용하여 개발되었습니다.
### 주요 특징
- 한글과 영어 텍스트 모두 지원
- 다양한 문자 타입 분석
- 유니코드 완전 지원
- 실시간 텍스트 통계 제공
### 확장 가능성
- 텍스트 감정 분석
- 언어 자동 감지
- 가독성 점수 계산
- 키워드 추출
## 문제 해결
### 자주 발생하는 문제
1. **모듈을 찾을 수 없음**: 가상환경이 활성화되었는지 확인
2. **포트 충돌**: 다른 MCP 서버가 실행 중인지 확인
3. **권한 문제**: Python 실행 권한 확인
### 로그 확인
```bash
# 디버그 모드로 실행
fastmcp dev text_analyzer_server.py --verbose
```
## 라이선스
MIT License
## 기여
버그 리포트나 기능 요청은 GitHub Issues를 통해 제출해주세요.