What is Lobechat Mcp Plugin

lobechat-mcp-plugin is a server designed to connect MCP (Model Context Protocol) and OpenAPI plugins within the LobeChat environment, enabling seamless integration of various functionalities.

Use cases

Use cases for lobechat-mcp-plugin include creating custom chatbots that leverage multiple APIs, integrating third-party services into LobeChat, and developing plugins that enhance the functionality of chat applications.

How to use

To use lobechat-mcp-plugin, create a ‘config.json’ file to configure your server settings, start the server using the command ‘npx -y lobechat-mcp-plugin’, and then add the plugin to LobeChat by following the documentation for custom plugins.

Key features

Key features include the ability to connect multiple MCP and OpenAPI servers, customizable configuration options, and easy integration with LobeChat through a simple plugin installation process.

Where to use

lobechat-mcp-plugin can be used in various fields including software development, chatbot integration, and any application that requires interaction with MCP or OpenAPI services.

Lobe Chat MCP and OpenAPI Plugin Server

A server that allows you to connect to MCP (Model Context Protocol) servers and OpenAPI servers and use them as plugins in LobeChat.

Quick Start

1. Create a config.json file (or copy from config.example.json):

{
  "publicUrl": "http://localhost:3000",
  "upstream": [],
  "servers": {
    "example": {
      "type": "mcp:sse",
      "url": "http://localhost:8080/v1",
      "options": {
        "eventSourceInit": {}
      },
      "author": "Your Name",
      "createdAt": "2023-01-01",
      "homepage": "https://github.com/username/your-project",
      "meta": {
        "avatar": "https://example.com/avatar.png",
        "title": "Example MCP Plugin",
        "description": "An example MCP plugin for LobeChat",
        "tags": [
          "example",
          "mcp"
        ]
      }
    }
  }
}

2. Start the server:

# Start with default config.json in current directory
npx -y lobechat-mcp-plugin

# Or specify a config file path
CONFIG_PATH=./my-config.json npx -y lobechat-mcp-plugin

# Specify a custom port (default is 3000)
PORT=8080 npx -y lobechat-mcp-plugin

3. Add the plugin to LobeChat by following the steps in the LobeChat documentation:

• In the chat window, open the plugin list in the toolbar
• Open the plugin store
• Add a new custom plugin
• Provide the Manifest URL: http://localhost:3000/<plugin-name>/manifest.json
• Install the plugin

By making this way, the plugin does not get automatically updated when you restart the server or the API changes. In order to always fetch the latest version, you can make the server your default marketplace by configuring the PLUGINS_INDEX_URL enviroment variable with the url of your lobechat-mcp-plugin server (e.g. http://localhost:3000). In that case you will be able to see all the plugins in the /discover/plugins page from your lobechat instance.[^1]

[^1]: The plugins view in the marketplace is cached, so it can take up to 12 hours for any new plugin or modification to appear. The store inside the chat always shows the latest plugins.

Defining the configuration options

MCP SSE Server

For connecting to an MCP server over SSE:

MCP Command Server

For spawning a local command that implements MCP:

The commands are executed in the same host as the lobechat-mcp-plugin server, so provide a valid path to the command.

Localization

The server supports localization of the plugin metadata. The metadata can be provided for a specific language by adding a meta:<language> property to the plugin configuration. The language should be a valid IETF language tag.

Development

API Endpoints

The server provides the following endpoints:

• GET / or GET /index*.json - Returns a list of available plugins, combining local plugins with upstream plugins. Used for listing the plugins in the marketplace.
• GET /:identifier/manifest.json - Returns the manifest for a specific plugin, including its tools and metadata. Used for installing the plugin.
• POST /gateway - Serves as a gateway for Lobe Chat plugin interactions. This is the main entrypoint for every request from Lobe Chat to the any plugin.
• POST /:identifier/:name - Handles tool calls for a specific plugin tool, passing the request body as arguments. This is redirected internally by the gateway to run the tool.

Development

# Clone the repository
git clone <repository-url>
cd lobechat-mcp-plugin

# Install dependencies
npm install

# Start development server
npm run dev

# Build the package
npm run build