워드웨어 MCP

Wordware의 강력한 에이전트 기능을 Claude 및 기타 MCP 호환 AI 어시스턴트와 통합하는 MCP(Model Context Protocol) 서버입니다.

개요

이 프로젝트는 Anthropic의 모델 컨텍스트 프로토콜(MCP)을 통해 Claude와 같은 AI 어시스턴트와 Wordware의 특수 에이전트 기능을 연결합니다. 이 통합은 구성에 따라 Wordware API에서 도구를 동적으로 로드하여 Claude가 모든 특수 Wordware 흐름에 접근할 수 있도록 합니다.

Related MCP server: OpenAI Agents MCP Server

특징

• 🔄 동적 도구 로딩 - 구성에 따라 Wordware API에서 도구를 자동으로 로드합니다.

• 🧠 지능형 스키마 감지 - 다양한 도구 입력 스키마를 자동으로 감지하고 이에 적응합니다.

• 🔍 고급 매개변수 처리 - 다양한 입력 형식(JSON, 중첩 구조, 문자열) 처리

• ⚙️ 강력한 오류 처리 - 포괄적인 오류 로깅 및 이벤트 루프 관리

• 🔑 간단한 인증 - Wordware 계정을 연결하기 위한 간편한 설정

필수 조건

• 파이썬 3.8 이상

• Wordware API 자격 증명

• Claude Desktop 또는 기타 MCP 호환 클라이언트

설치

지엑스피1

구성

다음 구조의 tools_config.json 파일을 만듭니다.

{
  "tools": [
    {
      "id": "your-tool-id-1"
    },
    {
      "id": "your-tool-id-2"
    },
    {
      "id": "your-tool-id-3"
    }
  ]
}

이 구성 파일에서 Wordware 도구 ID를 지정할 수 있으며, 서버는 해당 도구를 동적으로 로드하여 MCP 도구로 등록합니다. 입력 스키마와 설명을 포함한 도구 메타데이터는 Wordware API에서 직접 가져옵니다.

사용자 정의 구성 파일 경로를 지정하려면 CONFIG_PATH 환경 변수를 사용합니다.

서버 실행

# Run with default settings
python server.py

# Run with debug logging
python server.py --debug

# Run with SSE transport on a specific port
python server.py --transport sse --host 127.0.0.1 --port 8000

# Or install in Claude Desktop
mcp install python server.py --name "Wordware Tools"

작동 원리

Wordware MCP 서버는 다음과 같이 작동합니다.

1. 도구 구성 로딩 - 구성 파일에서 도구 ID 목록을 읽습니다.

2. 동적 도구 등록 - 각 도구 ID에 대해:

   • Wordware API에서 메타데이터를 가져옵니다.

   • 입력 스키마 요구 사항을 감지합니다.

   • 해당 MCP 도구 기능을 생성합니다.

   • MCP 서버에 도구를 등록합니다.

3. 요청 처리 - 도구가 호출될 때:

   • 다양한 형식(JSON 객체, 문자열, 중첩 구조)의 입력 매개변수를 처리합니다.

   • 도구 요구 사항에 따라 매개변수 형식을 조정합니다.

   • 올바르게 포맷된 요청을 Wordware API로 보냅니다.

4. 응답 처리 - Wordware API 응답을 처리합니다.

   • SSE(Server-Sent Events) 스트림을 구문 분석합니다.

   • 모든 출력 값을 수집합니다

   • Claude에 대한 응답을 사용자 친화적인 방식으로 형식화합니다.

고급 기능

지능형 매개변수 처리

서버는 다양한 입력 매개변수 형식을 자동으로 처리합니다.

• 직접 매개변수: {"Full Name": "John Doe", "Company": "Acme Inc."}

• kwargs의 JSON 문자열: {"kwargs": "{\"Full Name\": \"John Doe\", \"Company\": \"Acme Inc.\"}"}

• 중첩된 매개변수: {"kwargs": {"Full Name": "John Doe", "Company": "Acme Inc."}}

입력 스키마 감지

서버는 각 도구의 입력 스키마를 분석하여 올바른 형식을 결정합니다.

• 도구에 kwargs 객체로 래핑된 매개변수가 필요한지 감지합니다.

• 더 나은 문서화를 위해 내부 속성을 추출합니다.

• 각 도구에 대한 매개변수 형식을 자동으로 조정합니다.

오류 처리 및 복구

강력한 오류 처리에는 다음이 포함됩니다.

• 이벤트 루프 모니터링 및 복구

• 모든 요청 및 응답에 대한 자세한 로깅

• HTTP 오류 및 시간 초과의 우아한 처리

• 문제 해결을 위한 포괄적인 오류 메시지

문제 해결

• Claude Desktop에 도구가 표시되지 않음 : 서버가 실행 중이고 Claude Desktop 설정에 제대로 등록되어 있는지 확인하세요.

• 인증 오류 : Wordware API 키가 .env 파일에 올바르게 설정되었는지 확인하세요.

• 매개변수 검증 오류 : 입력 형식이 도구 요구 사항과 일치하는지 확인하세요.

• 이벤트 루프 오류 : "이벤트 루프가 닫혔습니다" 오류가 표시되면 서버를 다시 시작해 보세요.

개발

서버를 확장하거나 수정하려면:

# Run with debug logging
python server.py --debug

# Check the logs for detailed information
tail -f /path/to/your/logs/mcp.log

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

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

감사의 말

• 모델 컨텍스트 프로토콜을 위한 Anthropic

• 에이전트 플랫폼을 위한 Wordware

• 프로토콜 구현을 위한 MCP Python SDK