使用说明
MCP服务器示例
本项目演示了如何使用Spring构建具有STDIO传输的MCP（模型上下文协议）服务器。
🛠️ 工具服务
该项目包括两个服务类，它们提供了可通过MCP服务器访问的各种工具。每个服务都封装了一组与用户或帐户相关的特定工具。
👤 UserTools 服务
此服务包含与用户操作相关的工具。它包括以下四个工具：
-
get_all_users
检索系统中所有用户的列表。 -
get_user_by_id
通过用户的唯一ID获取用户的详细信息。 -
get_username_by_id
仅返回基于特定用户ID的用户名。 -
get_user_by_phone
使用用户的电话号码查找并返回用户信息。
💼 AccountTools 服务
此服务包括与用户帐户操作相关的工具。它目前提供以下工具：
get_accounts_by_user_id
检索与给定用户ID关联的所有帐户记录。
🏗️ 建设项目
要在不运行测试的情况下构建项目，请使用以下命令：
./mvnw clean install -DskipTests
这将编译代码并将应用程序打包为JAR文件，跳过任何测试执行。 输出JAR文件将位于target/目录中。
⚙️ Claude桌面配置
使用此MCP服务器 克劳德桌面，您需要编辑您的 claude_desktop_config.json 文件。
将以下条目添加到您的配置中：
{
"user-mcp-server": {
"command": "java",
"args": [
"-jar",
"/absolute/path/to/target/mcp-server-example-0.0.1-SNAPSHOT.jar"
],
"env": {
"USER_SERVICE_URL": "https://jsonplaceholder.typicode.com/users"
}
}
}
将/aolute/path/to/替换为构建的jar文件的实际路径。
📌 示例问题和答案
- ❓ 问题
- 🛠️ 使用过的工具
- 💬 响应
❓我们有多少用户？
🛠️ get_all_users
💬 你有 10用户 在您的系统中。
❓ 找到电话号码为的用户 1-770-736-8031 x56442
🛠️ get_user_by_phone
💬 我找到了有电话号码的用户 1-770-736-8031 x56442:
姓名： 琳恩·格雷厄姆
身份证件： 1
用户名： 布雷特
电子邮件： Sincere@april.biz
电话： 1-770-736-8031 x56442
网站： childegard.org
地址： Kulas Light，Gwenborough 556室，邮编92998-3874
❓ 计算ID为3的用户的总余额，并给我账户的平均余额
🛠️ get_accounts_by_user_id get_user_by_id
💬 以下是的帐户详细信息 克莱门汀·鲍奇 （用户ID:3）：
个人账户余额：
- 账户ID 5:3000.00美元
- 账户ID:2500.00美元
- 账号7:400.00美元
所有账户的总余额：5900.00美元
每个账户的平均余额：1966.67美元 （总计：5900美元÷3个账户=1966.67美元）
