From 5d54bf5afec997bf5fbf503bdd95b04b4515ccbc Mon Sep 17 00:00:00 2001 From: dcaslin Date: Fri, 12 Jun 2026 21:20:47 -0400 Subject: [PATCH 1/2] fix(docs): launch server with fastmcp CLI instead of mcp run The server is built on standalone FastMCP v3 (`from fastmcp import FastMCP`), but the README configured Claude Desktop to launch it with `mcp run` from the `mcp[cli]` SDK. That launcher only accepts the SDK's bundled `mcp.server.fastmcp.server.FastMCP` class and rejects the standalone v3 object as 'not a valid server object', so the server fails to start. Switch the documented config to the matching launcher: `--with fastmcp` and `fastmcp run`. Co-Authored-By: Claude Opus 4.8 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e171b54..5111ced 100644 --- a/README.md +++ b/README.md @@ -34,10 +34,10 @@ A Model Context Protocol (MCP) server for integrating with the [Boostcamp](https "args": [ "run", "--with", - "mcp[cli]", + "fastmcp", "--with-editable", "/path/to/your/boostcamp-mcp", - "mcp", + "fastmcp", "run", "/path/to/your/boostcamp-mcp/src/boostcamp_mcp/server.py" ] From 6f023e4ef6b60094bee57783b67e72549b6f3214 Mon Sep 17 00:00:00 2001 From: dcaslin Date: Fri, 12 Jun 2026 21:47:51 -0400 Subject: [PATCH 2/2] docs: add --directory so uv runs from the project root Without --directory, uv resolves the environment relative to wherever Claude Desktop spawns the process, so the server's working directory (and the .boostcamp session state it reads) doesn't line up with the project. Matches the verified working config. Co-Authored-By: Claude Fable 5 --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 5111ced..c642f77 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,8 @@ A Model Context Protocol (MCP) server for integrating with the [Boostcamp](https "command": "uv", "args": [ "run", + "--directory", + "/path/to/your/boostcamp-mcp", "--with", "fastmcp", "--with-editable",