GibWork MCP Server

A Model Context Protocol (MCP) server implementation for interacting with the GibWork platform. This server provides tools for managing tasks on the GibWork platform through an MCP.

Features

• Task Management: Create, retrieve, and search tasks on the GibWork platform
• MCP Protocol: Implements the Model Context Protocol for standardized tool interactions

Prerequisites

• Node.js (latest LTS version recommended)
• pnpm package manager (version 10.5.2 or higher)
• Solana private key (for task creation)

Installation

1. Clone the repository:

git clone 
cd gibwork-mcp

2. Install dependencies:

pnpm install

3. Create a .env file in the root directory and add your Solana private key:

SOLANA_PRIVATE_KEY=your_private_key_here

4. Configure Claude Desktop:

• Open Claude Desktop settings
• Navigate to Developer settings
• Edit the configuration file at:
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Add the following configuration:

{
     "mcpServers": {
       "gibwork": {
         "command": "C:\\Program Files\\nodejs\\node",
         "args": ["C:\\path\\to\\gibwork-mcp\\dist\\index.js"]
       }
     }
   }

Note: Adjust the paths according to your system configuration.

For more detailed information about MCP configuration, visit Model Context Protocol Quickstart Guide.

Project Structure

gibwork-mcp/
├── src/
│   ├── index.ts      # Main server implementation
│   └── utils.ts      # Utility functions for API interactions
├── dist/             # Compiled JavaScript output
├── package.json      # Project dependencies and scripts
└── tsconfig.json     # TypeScript configuration

Available Tools

The server implements the following MCP tools:

1. get-tasks-by-id

• Fetches a specific task by its ID
• Parameters: id (string)

2. get-tasks

• Retrieves tasks with pagination and filtering
• Parameters:
• page (number, default: 1)
• limit (number, default: 15)
• pageAll (boolean, default: false)
• search (string, default: '')
• orderBy (string, default: '')
• tags (string[], default: [])

3. create-task

• Creates a new task on the GibWork platform
• Parameters:
• title (string)
• content (string)
• requirements (string)
• tags (string[])
• payer (string)
• token (object)

Development

1. Build the project:

pnpm build

2. Run the development server:

pnpm dev

Configuration

The server is configured to run with the following settings:

• API Base URL: https://api2.gib.work
• Module System: ES Modules
• Target: ES2022
• Strict Type Checking: Enabled

Security

• The .env file containing sensitive information is excluded from version control
• Solana private key should be kept secure and never committed to the repository

License

ISC License