MCP客户端库

dependencies:
  mcp-client:
    github: ralsina/mcp-client

require "mcp-client"

# Create a client with STDIO transport
client = MCP::Client.new("npx", ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory"])

# Connect to the server
server_info = client.connect
puts "Connected to #{server_info.name} v#{server_info.version}"

# List available tools
tools = client.list_tools
tools.each do |tool|
  puts "#{tool.name}: #{tool.description}"
end

# Call a tool
result = client.call_tool("read_file", {"path" => JSON::Any.new("/path/to/file.txt")})
puts result.content.first["text"]?.try(&.as_s)

# Disconnect when done
client.disconnect

require "mcp-client"

# Create a custom transport
class MyTransport < MCP::Transport
  def connect : Nil
    # Your connection logic
  end

  def disconnect : Nil
    # Your disconnect logic
  end

  def send_message(message : String) : Nil
    # Your send logic
  end

  def receive_message : String?
    # Your receive logic
  end

  def connected? : Bool
    # Your connection status
  end
end

# Use custom transport
transport = MyTransport.new
client_info = MCP::ClientInfo.new("my-client", "1.0.0")
client = MCP::Client.new(transport, client_info)

client = MCP::Client.new("npx", ["-y", "@modelcontextprotocol/server-example"])
client.connect

# Check what the server supports
if client.supports_tools?
  puts "Server supports tools"
end

if client.supports_resources?
  puts "Server supports resources"
end

# Get full capabilities object
caps = client.server_capabilities

crystal spec

shards build

# Basic example
./bin/basic_tool_client /tmp

# Advanced example
./bin/advanced_usage /tmp