AI导哈

MCP服务器示例

一个基于Java的MCP（Model Context Protocol）服务器示例，提供同步工具暴露功能，适用于开发者学习和扩展。

  • by kencopas
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 kencopas/JavaSampleMCP

使用说明

Java示例MCP服务器

此存储库提供了最小的 Java示例实现 MCP（模型上下文协议）服务器。
它适用于任何想要：

  • 克隆项目
  • 运行一个展示同步工具的小型示例服务器
  • 扩展功能以实现自己的工具和行为

包含的功能

  • 一个小型Java应用程序(com.example.Application)使用SDK和 stdio传输提供商.
  • 名为的内置同步工具 get_presentations 其返回示例演示文稿的列表。
  • A. Presentation 记录和 PresentationTools 包含示例数据和简单查找方法的辅助类。

需求

  • Java 21
  • 梅文

构建并运行

  1. 克隆存储库。

  2. 使用Maven构建项目：

    mvn clean package

  3. 运行在中生成的着色JAR target:

    java -jar target/gson-demo-1.0-SNAPSHOT.jar

服务器已配置为使用 标准输入/输出 作为运输。
使用支持MCP的客户端或通过STDIO通信的简单包装器来调用公开的工具。

使用GitHub Copilot设置MCP服务器

您可以使用 GitHub Copilot 以与MCP服务器交互。

打开 mcp.json

  • IntelliJ理念：
    打开GitHub Copilot聊天窗口→ 单击工具集图标→ 添加MCP工具 → 这将打开 mcp.json 文件。

  • Visual Studio代码：
    打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P 在Mac上）→ type MCP：打开用户配置 → 选择它以打开 mcp.json 文件。

添加自定义MCP服务器

一旦进入 mcp.json，添加以下配置：

{
  "servers": {
    "custom-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "C:\\path\\to\\gson-demo-1.0-SNAPSHOT.jar"
      ]
    }
  }
}

👉 将路径替换为构建的JAR文件的实际位置。

保存后，再次单击工具集图标——您现在应该看到您的 自定义mcp服务器 和那个 get_presentations 工具可用。

MCP检查员

要将MCP检查器用于此服务器，请执行以下操作：

  1. 确保 Node.js 已安装。

  2. 运行：

    npx @modelcontextprotocol/inspector

这将在浏览器中启动MCP检查器。
设置：

  • 命令 → java
  • 参数 → -jar path/to/gson-demo-1.0-SNAPSHOT.jar

连接后，您可以运行工具、资源和提示，并查看输入/输出模式。

扩展样本

  • 添加新工具：
    编辑 Application.java 注册其他 SyncToolSpecification 或其他SDK支持的功能。

  • 更改或扩展数据：
    更新 PresentationTools.java 从文件、数据库或外部API加载数据。

  • 自定义序列化：
    该项目目前以Gson为例。您可以替换或配置 ObjectMapper 由运输提供商使用。

备注

  • 这个示例有意地很小——它演示了SDK、传输和简单工具的连接。
    它是 可生产的.

  • 依赖关系包括 MCP-SDK 和 SLF4J（简易记录仪） 如声明中所述 pom.xml.

相关 MCP