Model Context Protocol Server

Identifier:

org.eclipse.mcp.modelContextProtocolServer

Since:

3.0

Description:

The org.eclipse.mcp.modelContextProtocolServer extension point is used to declare and instantiate Model Context Protocol Servers, Tools and Resources that run within the IDE's Process and expose IDE functionality for interaction with Agents and/or Developers.

Behind the scenes, declared MCP Servers will be instantiated using the modelcontextprotocol/java-sdk API and may be configured to serve over HTTP using Jetty.

A "Platform MCP Servers" preference page will let users:

Enable/Disable the Server
Customize the HTTP port

Contributors may be associated with an Activity/Capability to toggle their contributions to the server You may bind your own activities to categoryId "org.eclipse.mcp.activity" You may add your preference pages under parent You may add your own preference pages under the page "org.eclipse.mcp.preferences.general" You may use your own preferences to remove/add your tools to the server dynamically using ToolFactory.setVisibility

Configuration Markup:

<!ELEMENT extension (factory)+>

<!ATTLIST extension

id CDATA #IMPLIED

name CDATA #IMPLIED

point CDATA #REQUIRED>

id - an optional identifier of the extension instance
name - an optional name of the extension instance
point - a fully qualified identifier of the target extension point

<!ELEMENT contributor (factory)+>

<!ATTLIST contributor

id CDATA #REQUIRED

name CDATA #REQUIRED

description CDATA #REQUIRED

provider CDATA #REQUIRED

activityId CDATA #IMPLIED>

This element is used to define a Model Context Protocol Tool

id - the unique identifier of this factory
name - The name of this MCP factory
description - A description of the tools, resources and prompts this factory contributes
provider - The name of product contributing this factory
activityId - Contributors may be associated with an Activity/Capability to toggle the presence of their contributions on the server You may bind your own activities to categoryId "org.eclipse.mcp.activity" Enabling / Disabling an activity that has contributors assocated with it will trigger the server to restart

<!ELEMENT factory EMPTY>

<!ATTLIST factory

class CDATA #REQUIRED>

Add one or more IFactories to this contributor. There are different descendants of IFactory tailored for tool creation, annotated tool creation, dynamic resource addition/subtraction, and resource templating with substitution variables w/ content assist

class - The fully qualified name of an IFactory implemention. Must implement org.eclipse.mcp.factory.IFactory and have an zero-parameter constructor.

Examples:

The following is an example of several activity and category definitions as well as associated bindings.


  <extension
         point="org.eclipse.mcp.modelContextProtocolServer"
         id="foo.com.my.extension.id"
         name="My MCP Extension">

      <contributor
         id="foo.com.my.contributor.id"
         name="My MCP Contributor"
         description="My MCP Contributor Description"
         provider="My Product"
         activityId="foo.com.my.activity.id">
         <factory class = "foo.com.MyFactory"/>
      </contributor>
   </extension>

API Information:

See the java docs for org.eclipse.mcp for java interface documentationm

Two tracing options are available on the General > Tracing preference page

# Main Debug Trace switch
- org.eclipse.mcp/debug
# Trace location for implementations
- org.eclipse.mcp/debug/implementations

Copyright (c) 2025 IBM Corporation and others.
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-v20.html/ SPDX-License-Identifier: EPL-2.0