A library for implementing mcp servers in MoonBit.

moon add peter-jerry-ye/mcp-server@0.3.5

Download zip

Author

peter-jerry-ye

Version

0.3.5

License

Apache-2.0

Repository

github.com/peter-jerry-ye/mcp-server

Last updated

last year

Downloads

Dependencies

peter-jerry-ye/async0.1.7
moonbitlang/x0.4.25

README

#MCP Server SDK

A WIP MoonBit implementation to support Model Context Protocol.

Supported backends:

Wasm's Component Model
Native backend

and more (as long as an implementation exists for peter-jerry-ye/async/stream).

The user can use this to develop a running MCP server, providing more functionality to their AI models.

#Currently Supported Features

Version:

2024-11-05

Transport:

Stdio

Provide server capabilities:

Tools
Prompts

Call client capabilities (if provided):

List roots

#Example

See ./example for a simple weather MCP server in Wasm, and ./example-c for a simple MCP server in native backend.

#TODO

Add documentation
Add tests
Support more features
Better error handling and better UX

#
Content

source

pub(all) enum Content {
  Text(String)
  Image(String, String)
  Resource(String, String, String)
}

#
LogLevel

source

pub(all) enum LogLevel {
  Debug
  Info
  Notice
  Warning
  Error
  Critical
  Alert
  Emergency
}

RFC 5424

impl Compare for LogLevel

impl Eq for LogLevel

impl Show for LogLevel

#
PromptArgument

source

type PromptArgument

#
PromptMessage

source

pub(all) struct PromptMessage {
  role : Role
  message : Content
}

#
Response

source

pub(all) struct Response {
  isError : Bool
  payload : Array[Content]
}

#
Role

source

pub(all) enum Role {
  User
  Assistant
}

#
Root

source

pub struct Root {
  uri : String
  name : String?
}

impl Eq for Root

impl Show for Root

#
Server

source

type Server

#
Server::add_prompt

source

fn Server::add_prompt(self : Server, name~ : String, description~ : String, arguments~ : Array[PromptArgument] = .., cb~ : (Map[String, Json]) -> Array[PromptMessage]) -> Unit

#
Server::add_tool

source

fn Server::add_tool(self : Server, name~ : String, description~ : String, inputSchema~ : @peter-jerry-ye/mcp-server/schema.T
T, cb~ : (Json, Server) -> Response raise Error) -> Unit

#
Server::list_roots

source

fn Server::list_roots(self : Server) -> Array[Root] raise Error

#
Server::log

source

fn Server::log(self : Server, message : Json, level~ : LogLevel = ..) -> Unit

#
Server::remove_prompt

source

fn Server::remove_prompt(self : Server, name : String) -> Unit

#
Server::remove_tool

source

fn Server::remove_tool(self : Server, name : String) -> Unit

#
Server::serve

source

fn Server::serve(self : Server, stdin~ : @peter-jerry-ye/async/stream.Reader
Reader, stdout~ : @peter-jerry-ye/async/stream.Writer
Writer, stderr~ : @peter-jerry-ye/async/stream.Writer
Writer) -> Unit

#
new

source

fn new(seed : Bytes) -> Server

#
prompt_argument

source

fn prompt_argument(name : String, description? : String, required? : Bool) -> PromptArgument

Source Files

Site source Report issue Packages Build queue Skills Statistics

mcp-server

#MCP Server SDK

#Currently Supported Features

#Example

#TODO

#Content

#LogLevel

#PromptArgument

#PromptMessage

#Response

#Role

#Root

#Server

#Server::add_prompt

#Server::add_tool

#Server::list_roots

#Server::log

#Server::remove_prompt

#Server::remove_tool

#Server::serve

#new

#prompt_argument

Source Files

#
Content

#
LogLevel

#
PromptArgument

#
PromptMessage

#
Response

#
Role

#
Root

#
Server

#
Server::add_prompt

#
Server::add_tool

#
Server::list_roots

#
Server::log

#
Server::remove_prompt

#
Server::remove_tool

#
Server::serve

#
new

#
prompt_argument