Skip to content

Releases: mozilla-ai/mcpd-sdk-javascript

v0.0.2

20 Oct 13:58
3d1fee2

Choose a tag to compare

What's Changed

New Features

  • Add prompts support to SDK by @peteski22 in #4
  • Add resources and resource templates support to SDK by @peteski22 in #5

Breaking Changes ⚠️

  • Refactor SDK method names by @peteski22 in #6
    • getToolSchemas()getTools() at server namespace level
    • Removed console logging which can cause issues if downstream SDK consumers are providing MCP servers
  • Simplify SDK architecture - remove aggregation methods
    • REMOVED: client.getTools(), client.getToolSchemas()
    • Aggregation moved to mcpd-proxy
    • SDK now focuses on server-level operations via dynamic caller

Migration Guide

If using aggregation methods, either:

  • Switch to mcpd-proxy for unified multi-server aggregation
  • Use server-level methods: client.servers.<server>.getTools()

Full Changelog: v0.0.1...v0.0.2

v0.0.1

14 Oct 15:59
d4efd98

Choose a tag to compare

What's Changed

Initial release of the JavaScript/TypeScript SDK for mcpd, providing natural JavaScript syntax for MCP server management and tool execution.

Key Features

  • Dynamic tool access - Call MCP tools with natural JavaScript syntax: client.servers.time.tools.get_current_time({ timezone: 'UTC' })
  • AI framework integration - Generate callable functions for LangChain JS and Vercel AI SDK with getAgentTools()
  • Type-safe - Full TypeScript support with generated type definitions from MCP tool schemas
  • Dual module format - Ships both CommonJS and ESM for maximum compatibility
  • Health-aware - Automatic health checking and filtering of unhealthy servers
  • Comprehensive error handling - Typed exceptions for all failure modes

API

  • client.listServers() - List all configured MCP servers
  • client.getServerHealth(name?) - Get health status for servers
  • client.servers.foo.tools.bar(args) - Direct tool invocation
  • client.getAgentTools(options?) - Generate functions for AI frameworks
  • client.getToolSchemas(options?) - Get schemas for tool aggregation

Examples

Includes working examples for:

  • Basic usage
  • LangChain JS integration
  • Vercel AI SDK integration

Requirements

  • Node.js 22+ (LTS)

Full Changelog: https://github.com/mozilla-ai/mcpd-sdk-javascript/commits/v0.0.1