Sidaartha/mcp

MY MCP Server

A Spring Boot application that implements the Model Context Protocol (MCP) server, providing AI-powered tools for different platforms. This server can be integrated with Claude Desktop and other MCP-compatible clients.

Project Structure

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

Features

• Slack integration for status updates
• AI-powered tools using Spring AI
• Extensible architecture for adding new services
• Claude Desktop integration support

Setup

1. Clone the repository
2. Copy the example properties file:

   cp src/main/resources/application-example.properties src/main/resources/application.properties
   

3. Configure the application properties in src/main/resources/application.properties
4. Build the project using Maven:

   ./mvnw clean package -DskipTests
   

Claude Desktop Integration

To use this MCP server with Claude Desktop:

1. Build the project:

   ./mvnw clean package -DskipTests
   

2. Configure Claude Desktop by editing the configuration file:

   • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %AppData%\Claude\claude_desktop_config.json

3. Add the following configuration to the mcpServers section:

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

   Replace the paths with your actual Java path and JAR location.

4. Restart Claude Desktop

5. Verify the integration:

   • Look for the hammer icon in Claude Desktop
   • The available tools should be listed when you click the icon

   

Configuration

Slack Configuration

Add the following to your application.properties:

slack.token=your-slack-token

Adding New Services

To add a new service:

1. Create a new package under service/ for your service
2. Create the necessary service class, configuration, and exception classes
3. Register the service in SpringAiApplication.java

Development

The project follows these best practices:

• Separation of concerns with dedicated service packages
• Configuration properties for external services
• Custom exception handling
• Proper logging
• Clean architecture principles

Troubleshooting

If the MCP server is not showing up in Claude Desktop:

1. Check the configuration file syntax
2. Verify the paths in the configuration are absolute
3. Ensure the JAR file exists at the specified location
4. Check the logs in ~/Library/Logs/Claude/mcp*.log (MacOS/Linux) or %AppData%\Claude\logs\mcp*.log (Windows)

License

This project is licensed under the MIT License—see the file for details.