floci-mcp

로컬 Floci 인스턴스에서 AI 에이전트가 AWS 형태의 리소스를 배포하고 관리할 수 있게 해주는 MCP 서버입니다. — "이 파라미터로 EC2 인스턴스를 띄워줘", "S3 버킷과 DynamoDB 테이블을 만들어줘" 같은 요청을 처리합니다.

기능

Floci는 http://localhost:4566에서 76개의 AWS 서비스를 에뮬레이션합니다. floci-mcp는 이 엔드포인트를 MCP 호환 클라이언트에 세 가지 도구로 노출합니다:

• aws_call(service, action, params) — Floci에 대해 모든 AWS API 작업(모든 서비스, 모든 액션)을 호출합니다. 핵심 도구입니다. AWS API에 대한 얇은 패스스루이므로 작업별로 수제 도구를 만들 필요 없이 76개 서비스를 모두 커버합니다.

• floci_status() — Floci에 연결 가능한지 확인합니다.

• floci_inventory() — S3, DynamoDB, Lambda, EC2, SQS, SNS, ECS, RDS에 현재 배포된 리소스를 한 번의 호출로 요약합니다.

Related MCP server: AWS MCP Server

사전 요구 사항

• Python 3.10+

• 실행 중인 Floci 인스턴스 — floci start 또는 Docker 설정은 Floci README를 참조하세요.

설치

클론에서 설치 (아직 PyPI에 게시되지 않음):

git clone https://github.com/Awilliv/floci-mcp.git
cd floci-mcp
pip install -e .

PyPI에 게시된 후:

pip install floci-mcp

구성

환경 변수, 모두 선택 사항:

사용 예시

MCP 클라이언트에 등록한 후 에이전트에게 다음과 같이 요청할 수 있습니다:

"t3.micro 인스턴스 유형으로 ami-00000000을 사용해 EC2 인스턴스를 띄워줘"

"reports라는 S3 버킷과 파티션 키가 id인 users라는 DynamoDB 테이블을 만들어줘"

에이전트는 aws_call을 통해 이를 수행합니다. 에이전트는 이미 AWS API 파라미터 형태를 알고 있으므로 서비스별 도구가 없어도 작동합니다.

MCP 클라이언트에 등록

Claude Code

여기서 AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY를 명시적으로 설정하면(실행 셸의 환경에 의존하는 대신) 다른 곳에 실제 AWS 자격 증명이 내보내져 있어도 실수로 실제 AWS 자격 증명으로 요청에 서명하는 것을 방지할 수 있습니다.

claude mcp add floci -- floci-mcp

또는 .mcp.json에 추가:

{
  "mcpServers": {
    "floci": {
      "command": "floci-mcp",
      "env": {
        "FLOCI_ENDPOINT_URL": "http://localhost:4566",
        "AWS_ACCESS_KEY_ID": "test",
        "AWS_SECRET_ACCESS_KEY": "test"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "floci": {
      "command": "floci-mcp",
      "env": {
        "FLOCI_ENDPOINT_URL": "http://localhost:4566",
        "AWS_ACCESS_KEY_ID": "test",
        "AWS_SECRET_ACCESS_KEY": "test"
      }
    }
  }
}

Open WebUI (mcpo 경유)

Open WebUI는 MCP가 아닌 OpenAPI/도구 호출을 사용합니다. floci-mcp를 mcpo로 감싸 OpenAPI 서버로 노출합니다:

pip install mcpo
mcpo --port 8000 -- floci-mcp

그런 다음 Open WebUI에서 설정 → 도구 → 도구 서버 추가로 이동하여 http://localhost:8000을 추가합니다. mcpo는 환경 변수를 실행하는 floci-mcp 프로세스에 전달하므로 mcpo를 시작하기 전에 셸에서 FLOCI_ENDPOINT_URL 등을 설정하세요.

개발

pip install -e ".[test]"
pytest

tests/test_integration.py의 통합 테스트는 실행 중인 Floci 인스턴스가 필요하며, 연결할 수 없으면 자동으로 건너뜁니다.

라이선스

MIT