Java示例MCP服务器
此存储库提供了最小的 Java示例实现 MCP(模型上下文协议)服务器。\ 它适用于任何想要:
- 克隆项目
- 运行一个展示同步工具的小型示例服务器
- 扩展功能以实现自己的工具和行为
______________________________________________________________________
包含的功能
- 一个小型Java应用程序(
com.example.Application)使用SDK和 stdio传输提供商. - 名为的内置同步工具
get_presentations其返回示例演示文稿的列表。 - A.
Presentation记录和PresentationTools包含示例数据和简单查找方法的辅助类。
______________________________________________________________________
需求
- Java 21
- 梅文
______________________________________________________________________
构建并运行
- 克隆存储库。
- 使用Maven构建项目:
mvn clean package- 运行在中生成的着色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检查器用于此服务器,请执行以下操作:
- 确保 Node.js 已安装。
- 运行:
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.
______________________________________________________________________
