Class: Ask::MCP::Server

Inherits:
Object
  • Object
show all
Defined in:
lib/ask/mcp/server.rb,
lib/ask/mcp/server/stdio.rb

Defined Under Namespace

Classes: Stdio

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name:, version: "0.1.0", capabilities: {}, tools: {}, resources: {}, prompts: {}) ⇒ Server

Returns a new instance of Server.



8
9
10
11
12
13
14
15
 
# File 'lib/ask/mcp/server.rb', line 8

def initialize(name:, version: "0.1.0", capabilities: {}, tools: {}, resources: {}, prompts: {})
  @name = name
  @version = version
  @capabilities = capabilities
  @tools = tools
  @resources = resources
  @prompts = prompts
end

Instance Attribute Details

#capabilities ⇒ Object (readonly)

Returns the value of attribute capabilities.



6
7
8
 
# File 'lib/ask/mcp/server.rb', line 6

def capabilities
  @capabilities
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



6
7
8
 
# File 'lib/ask/mcp/server.rb', line 6

def name
  @name
end

#prompts ⇒ Object (readonly)

Returns the value of attribute prompts.



6
7
8
 
# File 'lib/ask/mcp/server.rb', line 6

def prompts
  @prompts
end

#resources ⇒ Object (readonly)

Returns the value of attribute resources.



6
7
8
 
# File 'lib/ask/mcp/server.rb', line 6

def resources
  @resources
end

#tools ⇒ Object (readonly)

Returns the value of attribute tools.



6
7
8
 
# File 'lib/ask/mcp/server.rb', line 6

def tools
  @tools
end

#version ⇒ Object (readonly)

Returns the value of attribute version.



6
7
8
 
# File 'lib/ask/mcp/server.rb', line 6

def version
  @version
end

Class Method Details

.start_stdio(name:, version: nil, tools: [], capabilities: { tools: {} }, resources: {}, prompts: {}, resource_templates: {}, debug: false) ⇒ Object

Start an MCP server over stdio. Blocking — designed to be the last line of an entry-point script.

Parameters:

  • name (String) —

    server name

  • version (String, nil) (defaults to: nil) —

    server version reported in serverInfo; defaults to the ask-mcp version when nil

  • tools (Array<#call, #name, #description, #params_schema>) (defaults to: []) —

    tool instances to expose

  • capabilities (Hash) (defaults to: { tools: {} }) —

    MCP capabilities (default: { tools: {} })

  • resources (Hash{String => #to_h, #content}) (defaults to: {}) —

    uri → resource objects

  • prompts (Hash{String => #to_h, #messages}) (defaults to: {}) —

    name → prompt objects

  • debug (Boolean) (defaults to: false) —

    enable stderr debug logging



51
52
53
54
55
56
 
# File 'lib/ask/mcp/server.rb', line 51

def self.start_stdio(name:, version: nil, tools: [], capabilities: { tools: {} }, resources: {},
                      prompts: {}, resource_templates: {}, debug: false)
  Stdio.new(name: name, version: version, tools: tools, capabilities: capabilities,
            resources: resources, prompts: prompts,
            resource_templates: resource_templates, debug: debug).start
end

Instance Method Details

#prompt_names ⇒ Object 



25
26
27
 
# File 'lib/ask/mcp/server.rb', line 25

def prompt_names
  @prompts.keys
end

#resource_uris ⇒ Object 



21
22
23
 
# File 'lib/ask/mcp/server.rb', line 21

def resource_uris
  @resources.keys
end

#to_h ⇒ Object 



29
30
31
32
33
34
35
36
37
38
 
# File 'lib/ask/mcp/server.rb', line 29

def to_h
  {
    name: @name,
    version: @version,
    capabilities: @capabilities,
    tools: @tools.values.map(&:to_h),
    resources: @resources.values.map(&:to_h),
    prompts: @prompts.values.map(&:to_h)
  }
end

#tool_names ⇒ Object 



17
18
19
 
# File 'lib/ask/mcp/server.rb', line 17

def tool_names
  @tools.keys
end