Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

Add CLAUDE.md with FastMCP development guidelines

Jeremiah Lowin3ce613b43a40
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..24f9846b1
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,30 @@
+# FastMCP Development Guidelines
+
+## Testing and Investigation
+
+### In-Memory Transport - Always Preferred
+
+When testing or investigating FastMCP servers, **always prefer the in-memory transport** unless you specifically need HTTP transport features. Pass a FastMCP server directly to a Client to eliminate separate processes and network complexity.
+
+```python
+# Create your FastMCP server
+mcp = FastMCP("TestServer")
+
+def greet(name: str) -> str:
+ return f"Hello, {name}!"
+
+# Pass server directly to client - uses in-memory transport
+async with Client(mcp) as client:
+ result = await client.call_tool("greet", {"name": "World"})
+```
+
+### When to Use HTTP Transport
+
+Only use HTTP transport when testing network-specific features. Prefer StreamableHttp over SSE as it's the modern approach.
+
+```python
+# Only when network testing is required
+async with Client(transport=StreamableHttpTransport(server_url)) as client:
+ result = await client.ping()
+```
\ No newline at end of file