# mcp-sample

**Repository Path**: ai-sample/mcp-sample

## Basic Information

- **Project Name**: mcp-sample
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP Sample Project

This is a sample project based on the MCP (Model Control Protocol) protocol, featuring implementations for both client and server, designed for developers interested in understanding or building applications based on the MCP protocol.

## Project Structure

- `mcp-client`: Client implementation, supporting both Servlet and Stdio modes.
- `mcp-server`: Server implementation, also supporting both Servlet and Stdio modes.
- `mcp-others`: Other related components.

## Features

- Supports running both client and server via Servlet and Stdio modes.
- Provides synchronization tools and services related to the MCP protocol.

## Installation and Execution

### Client

#### Using Servlet

1. Ensure Java and Maven are installed.
2. Navigate to the `mcp-client/mcp-client-servlet` directory.
3. Build the project with Maven: `mvn clean install`.
4. Start the application: `java -jar target/mcp-client-servlet.jar`.

#### Using Stdio

1. Ensure Java and Maven are installed.
2. Navigate to the `mcp-client/mcp-client-stdio` directory.
3. Build the project with Maven: `mvn clean install`.
4. Start the application: `java -jar target/mcp-client-stdio.jar`.

### Server

#### Using Servlet

1. Ensure Java and Maven are installed.
2. Navigate to the `mcp-server/mcp-server-servlet` directory.
3. Build the project with Maven: `mvn clean install`.
4. Start the application: `java -jar target/mcp-server-servlet.jar`.

#### Using Stdio

1. Ensure Java and Maven are installed.
2. Navigate to the `mcp-server/mcp-server-stdio` directory.
3. Build the project with Maven: `mvn clean install`.
4. Start the application: `java -jar target/mcp-server-stdio.jar`.

## Contribution

Contributions and issue reports are welcome. Please submit issues or pull requests via the project's Issues page.

## License

This project is licensed under the MIT License. See the LICENSE file in the project root directory for details.