How To Build MCP Server In Java

MCPAI代理

提供方 adimehtaa · 包名 @modelcontextprotocol/inspector

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个基于Java的MCP服务器构建工具,用于为AI助手如Claude提供标准化数据接口。

一句话选型结论

按资料字段整理

How To Build MCP Server In Java 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

MCP协议Java本地部署Java开发AI集成数据接口服务器构建

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector java -cp target/classes:$(mvn dependency:build-classpath -Dmdep.outputFile=/dev/stdout -q) dev.Main

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
How To Build MCP Server In Java当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方adimehtaa上游标注的维护方 adimehtaa
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@modelcontextprotocol/inspector · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.5 KB
来自项目仓库与上游目录的原文,未做删改

如何用Java构建MCP服务器

使用Java构建模型上下文协议(MCP)服务器的综合指南。该项目演示了如何创建一个基于Java的MCP服务器,该服务器通过Claude等AI助手可以使用的工具提供演示数据。

目录

  • 概述
  • 先决条件
  • 项目结构
  • 入门指南
  • 运行服务器
  • MCP检验员测试
  • 与Claude Desktop连接
  • 理解代码
  • 可用工具
  • 定制
  • 故障排除

概述

该项目实现了一个基于Java的MCP(模型上下文协议)服务器,该服务器通过标准化的接口公开演示数据。服务器使用 io.modelcontextprotocol.sdk 库来处理MCP通信,并提供AI助手可以调用的工具来检索有关Java演示文稿的信息。

什么是MCP?

模型上下文协议(MCP)是一个开放标准,使AI助手能够安全地连接到外部数据源和工具。它为应用程序向AI系统公开其功能提供了一种标准化的方式。

先决条件

  • Java 21或更高版本 -此项目使用Java 21功能
  • Maven 3.6+ -用于依赖关系管理和构建
  • Node.js和npm -MCP检验员测试所需(可选)
  • 克劳德桌面 -用于将服务器连接到Claude(可选)

项目结构```

how-to-build-mcp-server-in-java/
├── src/main/java/
│ └── dev/
│ ├── Main.java # Main server entry point
│ └── aditya/
│ ├── Presentation.java # Data model for presentations
│ └── PresentationTools.java # Business logic for managing presentations
├── pom.xml # Maven configuration
├── README.md # This documentation
└── .gitignore # Git ignore rules


## 入门指南

### 1.克隆存储库```bash
git clone
cd how-to-build-mcp-server-in-java

2.建设项目```bash

mvn clean compile


### 3.验证依赖关系

该项目使用以下关键依赖关系:

- `io.modelcontextprotocol.sdk:mcp` -Java版MCP SDK
- `org.slf4j:slf4j-api` 和 `org.slf4j:slf4j-simple` -日志记录

## 运行服务器

### 方法1:使用Maven```bash
mvn exec:java -Dexec.mainClass="dev.Main"

方法2:直接使用Java```bash

First compile

mvn compile

Then run

java -cp target/classes:target/dependency/* dev.Main


### 方法3:创建可执行JAR```bash
mvn package
java -jar target/how-to-build-mcp-server-in-java-1.0-SNAPSHOT.jar

MCP检验员测试

MCP检查器是一个调试工具,允许您以交互方式测试MCP服务器。

1.安装MCP检查器```bash

npm install -g @modelcontextprotocol/inspector


### 2.运行检查器```bash
npx @modelcontextprotocol/inspector java -cp target/classes:$(mvn dependency:build-classpath -Dmdep.outputFile=/dev/stdout -q) dev.Main

或者,如果你有一个编译好的JAR:```bash
npx @modelcontextprotocol/inspector java -jar target/how-to-build-mcp-server-in-java-1.0-SNAPSHOT.jar


### 3.使用检查器

1. 检查器将在您的浏览器中打开
1. 您将看到服务器功能和可用工具
1. 您可以测试 `get_presentations` 点击该工具
1. 检查器将显示来自服务器的JSON响应

## 与Claude Desktop连接

要将此MCP服务器与Claude Desktop一起使用,您需要在Claude的设置中对其进行配置。

### 1.找到Claude桌面配置

**在 macOS 上:**```bash
~/Library/Application Support/Claude/claude_desktop_config.json

在Windows上:```bash
%APPDATA%\Claude\claude_desktop_config.json


### 2.添加服务器配置

将Java MCP服务器添加到配置文件中:```json
{
"mcpServers": {
"java-presentations": {
"command": "java",
"args": [
"-cp",
"/path/to/your/project/target/classes:/path/to/your/project/target/dependency/*",
"dev.Main"
],
"cwd": "/path/to/your/project"
}
}
}

JAR文件的替代方案:```json
{
"mcpServers": {
"java-presentations": {
"command": "java",
"args": [
"-jar",
"/path/to/your/project/target/how-to-build-mcp-server-in-java-1.0-SNAPSHOT.jar"
]
}
}
}


### 3.重新启动克劳德桌面

保存配置后,重新启动Claude Desktop。现在,您应该可以向Claude询问演示文稿,它将使用您的Java MCP服务器来获取数据。

### 4.测试连接

试着问克劳德:

- “有哪些可用的演示文稿?”
- “显示2025年以来的所有Java演示文稿”
- “列出演示文稿URL”

## 理解代码

### 主类

主类通过以下方式设置MCP服务器:

- **传输层**:使用stdio进行通信
- **察看连接信息**:定义服务器名称和版本
- **能力**:声明服务器可以做什么(工具、日志记录)
- **工具注册**:注册可用工具及其实现

### 演示文稿.java

一个简单的记录类,表示演示文稿,具有:

- `title`:演示文稿标题
- `url`:链接到演示文稿
- `year`:发表演讲的年份

### 演示工具.java

包含用于管理演示文稿的业务逻辑:

- 初始化示例演示数据
- 提供检索演示文稿的方法
- 支持按年过滤
- 可以将演示文稿转换为不同的格式

## 可用工具

### get_presences

**描述**:检索所有可用Java演示文稿的列表

**参数**:

- `operation` (string):操作类型(当前未在实现中使用)

**退货**:包含标题、URL和年份信息的演示文稿列表

**示例响应**:```
Presentation[title=Java 24 Launch - Live from JavaOne 2025, url=https://www.youtube.com/watch?v=mk_2MIWxLI0, year=2025]
Presentation[title=Java Turns 30 - Live from JavaOne 2025, url=https://www.youtube.com/watch?v=GwR7Gvi80Xo, year=2025]
...

定制

添加新工具

要向MCP服务器添加新工具,请执行以下操作:

  1. 定义工具模式 JSON格式
  2. 创建工具规格 包含名称、描述和模式
  3. 执行工具逻辑 在处理函数中
  4. 注册该工具 使用服务器构建器

例子:```java
var newToolSpec = new McpServerFeatures.SyncToolSpecification(
new McpSchema.Tool("my_new_tool", "Description of what it does", schema),
(exchange, arguments) -> {
// Your tool implementation here
return new McpSchema.CallToolResult(contents, false);
}
);


### 修改数据

要更改演示文稿数据,请执行以下操作:

1. 在中编辑构造函数 `PresentationTools.java`
1. 添加、删除或修改 `Presentation` 物体
1. 重建并重新启动服务器

### 添加资源或提示

MCP SDK还支持资源和提示。您可以使用服务器构建器添加这些:```java
.resources(resourceSpecification)
.prompts(promptSpecification)

故障排除

常见问题

  1. “未找到类”错误:确保所有依赖项都在类路径中
  2. 端口已在使用中:服务器使用stdio,因此不应发生端口冲突
  3. JSON解析错误:检查您的工具模式是否为有效的JSON
  4. 克劳德桌面未连接:验证配置文件路径和语法

调试日志记录

该项目使用SLF4J进行日志记录。要查看调试输出,您可以调整日志记录级别或添加更多日志语句。

依赖性问题

如果您遇到依赖关系解决问题:bash mvn dependency:tree mvn clean install -U

后续步骤

  • 添加具有复杂参数的更复杂的工具
  • 实现用于提供文件或数据的资源端点
  • 为常见的AI交互添加提示模板
  • 创建与外部API或数据库交互的工具
  • 添加身份验证和安全功能

贡献

欢迎通过以下方式为该项目做出贡献:

  • 添加新的示例工具
  • 改进文件
  • 修复错误或问题
  • 添加测试

资源

  • MCP官方文件
  • MCP Java SDK
  • 克劳德桌面
  • MCP检查员

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
How To Build MCP Server In Java 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector java -cp target/classes:$(mvn dependency:build-classpath -Dmdep.outputFile=/dev/stdout -q) dev.Main。对应的包名是 @modelcontextprotocol/inspector。装完在客户端配置里引用同一个包或端点。

How To Build MCP Server In Java 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

How To Build MCP Server In Java 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

How To Build MCP Server In Java 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

How To Build MCP Server In Java 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

How To Build MCP Server In Java 能提供哪些能力?

资料显示能力标签包括 服务器构建、Java、Claude。具体工具清单以官方文档为准。

How To Build MCP Server In Java 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

How To Build MCP Server In Java 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。