packages/ai-mcp
| Name | Last commit message | Last commit date |
|---|---|---|
| .. | ||
README.md
@tanstack/ai-mcp#
Host-side Model Context Protocol (MCP) client for TanStack AI.
Discover and run MCP server tools, resources, and prompts inside any TanStack AI chat() / agent loop — across any provider adapter — with optional generated TypeScript types (typed tool names and pool keys).
Features#
createMCPClient({ transport })— connect to a single MCP server (Streamable HTTP, SSE, or stdio)createMCPClients({ ... })— connect to many servers at once with auto-prefix collision avoidance- Auto-discovery (
client.tools()) or explicit typed binding (client.tools([toolDefinition(...)])) @tanstack/ai-mcp/stdiosubpath — Node-only stdio transport, isolated so edge bundles stay clean- Bundled
tanstack-ai-mcp generateCLI — introspects live servers and emits TypeScript types forcreateMCPClient<MyServer>() [Symbol.asyncDispose]support — useawait usingfor automatic cleanup
Installation#
pnpm add @tanstack/ai-mcp @modelcontextprotocol/sdk
Quick Start#
import { createMCPClient } from '@tanstack/ai-mcp'
import { chat } from '@tanstack/ai'
import { openaiText } from '@tanstack/ai-openai/adapters'
const mcp = await createMCPClient({
transport: { type: 'http', url: 'https://your-mcp-server.com/mcp' },
})
const stream = chat({
adapter: openaiText('gpt-5.5'),
messages: [{ role: 'user', content: 'What is the weather in Brooklyn?' }],
tools: await mcp.tools(),
})
// Tools execute lazily while the stream is consumed — close only after
// the stream is fully drained (or hand lifecycle to chat() via the `mcp` option).
for await (const chunk of stream) {
// handle StreamChunks, or return toServerSentEventsResponse(stream) instead
}
await mcp.close()
License#
MIT