Skip to content

fix: remove deprecated stateless_http parameter from FastMCP initialization#59

Open
jihunparkme wants to merge 3 commits into
koreainvestment:mainfrom
jihunparkme:fix/remove-deprecated-stateless-http
Open

fix: remove deprecated stateless_http parameter from FastMCP initialization#59
jihunparkme wants to merge 3 commits into
koreainvestment:mainfrom
jihunparkme:fix/remove-deprecated-stateless-http

Conversation

@jihunparkme

@jihunparkme jihunparkme commented Mar 18, 2026

Copy link
Copy Markdown

Summary

FastMCP 라이브러리 업데이트에 따라 더 이상 지원되지 않는 stateless_http 파라미터를 제거하여 서버 실행 시 발생하는 TypeError를 해결했습니다.

Problem

최신 버전(v3.1.1)의 fastmcp 패키지를 사용할 경우, FastMCP 객체 초기화 시 stateless_http 인자를 전달하면 아래와 같은 에러가 발생하며 도커 컨테이너가 정상적으로 실행되지 않는 문제가 있습니다.

TypeError: FastMCP() no longer accepts `stateless_http`. 
Pass `stateless_http` to `run_http_async()` or `http_app()`, or set FASTMCP_STATELESS_HTTP.

관련하여 PrefectHQ/fastmcp@943af98 커밋에서 볼 수 있듯이, stateless_http 인자는 더 이상 FastMCP() 생성자에서 사용할 수 없으며 사용 시 TypeError를 발생시킵니다.

Key Changes

  • 코드 수정: FastMCP 생성자에서 더 이상 지원되지 않는 stateless_http 파라미터를 제거했습니다.
    • 해당 설정이 필요한 경우 이제 환경 변수(FASTMCP_STATELESS_HTTP)를 통해 제어 가능합니다.
  • 의존성 업데이트: 최신 구조와의 호환성을 보장하기 위해 fastmcp 최소 버전을 3.1.1로 상향 조정했습니다.
    • fastmcp>=2.11.3 → fastmcp>=3.1.1

Test Results

[x] Docker 빌드 및 MCP 서버 정상 기동 확인

@kdsull

kdsull commented Apr 8, 2026

Copy link
Copy Markdown

몇 번을 돌려도 똑 같은 에러로 exit 되는군요 :

13:57:52 [INFO] ✅ KIS 설정 파일이 생성되었습니다: /root/KIS/config/kis_devlp.yaml
13:57:52 [INFO] 📋 KIS 설정 요약:
13:57:52 [INFO] - 실제 거래: ✅
13:57:52 [INFO] - 모의 거래: ✅
13:57:52 [INFO] - 계좌번호: ✅
13:57:52 [INFO] - URL 설정: ❌
13:57:52 [INFO] setup database ...
13:57:52 [INFO] Database singleton instance created
13:57:52 [INFO] Tables created for configs/master/master.db
13:57:52 [INFO] Database engine initialized: configs/master/master.db
13:57:52 [INFO] Created master database engine with all models
13:57:52 [INFO] Master database engine initialized: 'configs/master/master.db'
13:57:52 [INFO] Available databases: ['master']
13:57:52 [INFO] 📁 Available databases: ['master']
Traceback (most recent call last):
File "/app/server.py", line 103, in
main()
~~~~^^
File "/app/server.py", line 46, in main
mcp_server = FastMCP(
name="My Awesome MCP Server",
...<2 lines>...
stateless_http=False,
)
File "/app/.venv/lib/python3.13/site-packages/fastmcp/server/server.py", line 287, in init
_check_removed_kwargs(kwargs)
~~~~~~~~~~~~~~~~~~~~~^^^^^^^^
File "/app/.venv/lib/python3.13/site-packages/fastmcp/server/server.py", line 146, in _check_removed_kwargs
raise TypeError(
f"FastMCP() no longer accepts {key}. {_REMOVED_KWARGS[key]}"
)
TypeError: FastMCP() no longer accepts stateless_http. Pass stateless_http to run_http_async() or http_app(), or set FASTMCP_STATELESS_HTTP.
13:57:52 [INFO] Database engine closed: configs/master/master.db
13:57:52 [INFO] Closed database: master
13:57:52 [INFO] All database connections closed

@jihunparkme

jihunparkme commented Apr 18, 2026

Copy link
Copy Markdown
Author

@kdsull 안녕하세요. 확인 감사합니다.

코드상으로는 수정되었으나, 로그를 보니 실행 환경(Docker)에서 이전 빌드 결과물이 남아있어 에러가 반복되는 것으로 추측됩니다. 번거로우시겠지만, 아래 두 사항을 한 번만 더 확인해 주실 수 있을까요?

  • 체크아웃된 브랜치의 server.py에서 stateless_http 파라미터가 실제로 삭제되었는지 확인 부탁드립니다.
  • 기존 이미지를 제거 후 stateless_http 파라미터가 삭제된 최신 코드에 대한 이미지를 새로 빌드한 뒤 실행하여 확인 부탁드립니다.

@jinwoo-lee-github

jinwoo-lee-github commented Apr 21, 2026

Copy link
Copy Markdown

저도 지금 받아서 실행해보는건데 동일하네요? 이거 수정되면 돌아가려나요 .. @kdsull 님하고 같은 오류가 발생되는데

@jihunparkme

Copy link
Copy Markdown
Author

@kdsull 한투 담당자분이 PR 확인하시고 답변주신건 줄 알았는데, 동일한 에러를 겪으신 분이셨군요..ㅎㅎ

@jinwoo-lee-github 담당자분 확인이 아직 안된 것 같아서, 급하시면 제가 수정한 브랜치로 다시 빌드 후 실행시켜보시면 잘 동작할겁니다!

@jinwoo-lee-github

Copy link
Copy Markdown

네 별관심없는듯 수정해서 실행했어요 ㅎㅎ

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants