MCP_server-Uptexty

Salsabil-210/MCP_server-Uptexty

3.1

If you are the rightful owner of MCP_server-Uptexty and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Uptexty Server is a minimal Model Context Protocol (MCP) server template designed for integration with Claude Desktop, providing a foundation for developing custom AI tools and resources using Go.

MCP Uptexty Server šŸš€

A minimal Model Context Protocol (MCP) server template for Claude Desktop integration. Built with Go, this server provides a foundation for creating custom AI tools and resources.

šŸ“¦ Features

  • Basic MCP protocol implementation
  • Claude Desktop integration
  • Ready for custom tool development

šŸ› ļø Installation

Prerequisites

  • Go 1.18 or later
  • Claude Desktop installed

Build Steps

  1. Clone or download the project

    cd MCP_Uptexty

  2. Install dependencies

    go mod tidy

  3. Build the project

    go build

  4. Run the server

    ./mcp-uptexty

šŸš€ Usage

Starting the Server

# Build and run in one command
go run .

# Or build first, then run
go build
./mcp-uptexty

Expected Output

Connected to Claude Desktop!
 Connection closed

Error Handling

  • Connection errors are logged with detailed information
  • Server errors are propagated to main function
  • Graceful shutdown with proper cleanup

šŸ—ļø Project Structure

mcp-uptexty/
ā”œā”€ā”€ main.go          # Main entry point
ā”œā”€ā”€ server.go        # MCP server implementation
ā”œā”€ā”€ client.go        # Client implementation (for testing)
ā”œā”€ā”€ go.mod           # Go module dependencies
ā”œā”€ā”€ go.sum           # Dependency checksums
ā””ā”€ā”€ README.md        # This file

Claude Desktop Configuration

šŸ”§ Configuration

Add to your Claude Desktop configuration file (claude_desktop_config.json): { "servers": [ { "name": "mcp-uptexty", "command": "", "args": [], "workingDirectory": "", "timeout": 30 } ] }

Server Settings

  • Name: mcp-uptexty
  • Version: 1.0.0
  • Transport: Stdio (for Claude Desktop integration)

Dependencies

  • MCP SDK: github.com/modelcontextprotocol/go-sdk v0.3.0
  • Go Version: 1.25.0+

StartServer()

func StartServer() error

Initializes and starts the MCP server with stdio transport. Establishes a connection to Claude Desktop and manages the server session lifecycle.

Returns: error - nil on success, error details on failure

šŸ” Development

Adding Custom Tools

The server is designed to be easily extensible. You can add custom MCP tools by:

  1. Implementing tool handlers
  2. Registering tools with the server
  3. Defining input/output schemas

Testing

# Run tests
go test

# Run with verbose output
go test -v

  1. Connection Failed

    • Ensure Claude Desktop is running
    • Check if the port is available
    • Verify MCP protocol compatibility

  2. Build Errors

    • Ensure Go 1.18+ is installed
    • Run go mod tidy to fix dependencies
    • Check import paths

  3. Runtime Errors

    • Check log output for detailed error messages
    • Verify transport configuration
    • Ensure proper context handling

šŸ”— Related Links