Embabel MCP File Server

🔌 Embabel框架：如何构建MCP服务器

此存储库演示了如何构建 模型上下文协议（MCP）服务器 使用Embabel框架和Spring Boot。该应用程序将本地文件系统功能（CRUD操作）公开为外部AI代理（如Claude Desktop）可以连接和使用的“工具”。

📖 完整指南：有关详细解释和完整代码演练，请阅读我们的综合教程。

👉 Embabel框架：如何构建MCP服务器

🎥 视频教程：更喜欢动手学习？观看我们的分步实施指南。

👉 YouTube教程- 使用Embabel框架构建自己的MCP服务器：将Claude连接到本地文件！

▶️ Watch on YouTube

______________________________________________________________________

✨ 这个项目展示了什么

此应用程序展示了如何 允许AI代理访问工具:

• 模型上下文协议（MCP） 使用Embabel和Spring Boot实现。
• 工具曝光 使用Embabel的 @Export 注释，将Java方法转化为AI工具。
• 文件系统操作 允许AI创建、读取、编辑和删除文件。
• SSE（服务器发送事件） 用于实时代理通信的传输层。

______________________________________________________________________

📋 先决条件

在运行此应用程序之前，请确保您已经：

• Java 21 或更高
• OpenRouter API密钥 （免费套餐可在 OpenRouter.ai)
• Node.js （可选，如果使用MCP检验员进行测试，则为必填项）
• Claude桌面应用程序 （可选，用于真实世界的代理测试）

______________________________________________________________________

🚀 快速开始

1.️⃣ 克隆存储库

git clone https://github.com/BootcampToProd/embabel-mcp-file-server.git
cd embabel-mcp-file-server

2.️⃣ 配置API密钥

提供您的OpenRouter API密钥作为环境变量。

OPENAI_API_KEY={YOUR_OPENROUTER_API_KEY}

3.️⃣ 构建项目

mvn clean install

4.️⃣ 运行应用程序

mvn spring-boot:run

服务器将于启动 http://localhost:8080MCP端点暴露于 /sse.

______________________________________________________________________

💡 如何测试

您可以使用以下命令测试服务器 克劳德桌面版 或 MCP检查员.

🤖 选项1:克劳德桌面（推荐）

1. 打开您的Claude Desktop配置文件：

- 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加以下配置：

{
  "mcpServers": {
    "embabel-file-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8080/sse"
      ]
    }
  }
}

1. 重新启动克劳德桌面。您应该看到一个连接图标。

1. 问克劳德： “创建一个名为 hello_world.txt 一首关于Java的短诗。"

🔍 选项2:MCP检查员

如果要手动调试工具：

1. 确保Spring Boot应用程序正在运行。
2. 在终端中运行检查器：

   npx @modelcontextprotocol/inspector

1. 在打开的浏览器窗口中：

- 选择 上海证券交易所. - 输入URL: http://localhost:8080/sse. - 点击 连接 并通过UI测试工具。