Azure Java SDK MCP Server

# MCP Server in JavaScript A Model Context Protocol (MCP) server implementation using JavaScript and the official MCP SDK. ## Overview This project demonstrates how to build an MCP server that can provide tools and resources to AI assistants. The Model Context Protocol enables secure, standardized connections between AI applications and external data sources. ## Features This MCP server includes the following tools: - **azure-java-sdk-code-samples-mcp-server** - Get readme.md for Azure Java SDK, which includes introduction, key concepts, and code samples ## Prerequisites - Node.js (version 18 or higher) - npm or yarn package manager ## Installation 1. Clone or download this project 2. Install dependencies: ```bash npm install ``` ## Usage ### Running the Server Start the MCP server: ```bash npm start ``` For development with debugging: ```bash npm run dev ``` Or press **F5** in VS Code to start debugging. ### Connecting to AI Assistants This MCP server can be connected to various AI assistants that support the Model Context Protocol: 1. **Claude Desktop** - See `MCP_CONFIG.md` for configuration details 2. **Continue.dev** - VS Code extension that supports MCP 3. **Other MCP clients** - Any client that supports stdio transport #### VS Code Sample `mcp.json` for connect locally. ```json { // 💡 Inputs are prompted on first server start, then stored securely by VS Code. "inputs": [ ], "servers": { "azure-java-sdk-mcp": { "type": "stdio", "command": "node", "args": [ "<path-to-index.js>" ] } } } ``` One may need to "start" it once, to cache the tools. ### Available VS Code Tasks - **Run MCP Server** - Starts the server normally - **Debug MCP Server** - Starts with Node.js inspector for debugging ## Development ### Project Structure ``` ├── index.js # Main MCP server implementation ├── package.json # Project configuration ├── .github/ │ └── copilot-instructions.md # Copilot customization └── README.md # This file ``` ### Adding New Tools To add a new tool: 1. Add the tool definition in the `ListToolsRequestSchema` handler 2. Implement the tool logic in the `CallToolRequestSchema` handler 3. Include proper input validation and error handling ### Error Handling The server uses `McpError` for proper error responses: - `ErrorCode.InvalidRequest` - For invalid parameters - `ErrorCode.MethodNotFound` - For unknown tools - `ErrorCode.InternalError` - For unexpected errors ## MCP Protocol This server implements the Model Context Protocol specification. For more information about MCP: - [MCP Documentation](https://modelcontextprotocol.io/) - [MCP Specification](https://spec.modelcontextprotocol.io/) ## License ISC License