AI导哈

MCP协议服务器

一个基于Spring Boot的MCP协议服务器，提供AI工具集成和Slack状态更新功能，适用于Claude Desktop等MCP兼容客户端。

  • by Sidaartha
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 sidaartha/mcp

使用说明

MY MCP服务器

一个实现模型上下文协议（MCP）服务器的Spring Boot应用程序，为不同平台提供AI驱动的工具。此服务器可以与Claude Desktop和其他MCP兼容客户端集成。

项目结构

src/main/java/com/sidaartha/mcp/
├── SpringAiApplication.java
├── service/
│   ├── slack/
│   │   ├── SlackService.java
│   │   ├── config/
│   │   │   └── SlackConfig.java
│   │   └── exception/
│   │       └── SlackServiceException.java
│   └── [other services]/
└── [common packages]/

特性

  • Slack集成用于状态更新
  • 使用Spring AI的AI驱动工具
  • 用于添加新服务的可扩展架构
  • Claude桌面集成支持

设置

  1. 克隆存储库
  2. 复制示例属性文件：
    cp src/main/resources/application-example.properties src/main/resources/application.properties
  3. 在中配置应用程序属性 src/main/resources/application.properties
  4. 使用Maven构建项目：
    ./mvnw clean package -DskipTests

Claude桌面集成

要将此MCP服务器与Claude Desktop一起使用：

  1. 构建项目：

    ./mvnw clean package -DskipTests

  2. 通过编辑配置文件配置Claude Desktop：

    • MacOS/Linux： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %AppData%\Claude\claude_desktop_config.json

  3. 将以下配置添加到 mcpServers 章节：

    {
  "mcpServers": {
    "my-mcp": {
      "command": "/path/to/java",
      "args": [
        "-jar",
        "/absolute/path/to/mcp/target/mcp-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

    将路径替换为实际的Java路径和JAR位置。

  4. 重新启动克劳德桌面

  5. 验证集成：

    • 在Claude Desktop中查找锤子图标
    • 单击图标时，应列出可用的工具

配置

松弛配置

将以下内容添加到您的 application.properties:

slack.token=your-slack-token

添加新服务

要添加新服务，请执行以下操作：

  1. 在下创建新包 service/ 为您服务
  2. 创建必要的服务类、配置和异常类
  3. 在中注册服务 SpringAiApplication.java

发展

该项目遵循以下最佳实践：

  • 通过专用服务包分离关注点
  • 外部服务的配置属性
  • 自定义异常处理
  • 正确记录
  • 清洁建筑原则

故障排除

如果MCP服务器未显示在Claude Desktop中：

  1. 检查配置文件语法
  2. 验证配置中的路径是否为绝对路径
  3. 确保JAR文件存在于指定位置
  4. 检查登录 ~/Library/Logs/Claude/mcp*.log （MacOS/Linux）或 %AppData%\Claude\logs\mcp*.log （Windows）

许可证

该项目根据MIT许可证获得许可——请参阅 许可证 文件以获取详细信息。

相关 MCP