Toolskit

You run a secure, configurable MCP server that harnesses a rich toolkit for filesystem operations, web access, document conversion, project management for npm and .NET, and generative AI via PiAPI.ai. It centralizes tools behind strict parameter validation, robust logging, and flexible access control so you can automate and safely orchestrate complex workflows from a single entry point.

How to use

You connect to the server using an MCP client and issue requests that target the toolset exposed by the server. The toolkit organizes capabilities into categories such as filesystem, Git, web access, Pandoc conversions, NPM and .NET operations, system utilities, and generative AI through PiAPI.ai. Each tool accepts a defined set of parameters and returns structured results or task identifiers you can poll for progress.

How to install

# Prerequisites
- Node.js and npm installed
- Git installed
- Pandoc installed
- .NET SDK installed
- Brave Search API key (for web search features)
- PiAPI.ai API key (for generative AI tools)

# Install project dependencies
npm install

# Build the server
npm run build

# Start the local MCP toolset (example runtime from config snippet)
node /chemin/vers/toolskit/build/index.js

Configuration and runtime notes

To configure the MCP toolset, you typically provide a runtime configuration that wires a local (stdio) process to the MCP framework. The following example shows how a local toolkit runner is defined and how it references its own config path.

Configuration and runtime notes (continued)

{
  "mcpServers": {
    "toolskit": {
      "command": "node",
      "args": ["/chemin/vers/toolskit/build/index.js"],
      "env": {
        "MCP_TOOLSKIT_CONFIG_PATH": "C:/tmp/config.json"
      }     
    }
  }
}

Environment and API keys

Configure the PiAPI AI integration by placing your API key and related options in the PiAPI section of the configuration. The example shows the key and related settings, including whether you are on a paid plan and where generated outputs go.

{
  "PiAPI": {
    "ApiKey": "your_piapi_key",
    "IsFreePlan": false,
    "IgnoreSSLErrors": false,
    "OuputDirectory": "C:/tmp/piapi_output"
  }
}

Notes on security and behavior

• All tool invocations go through strict parameter validation to prevent unsafe operations.
• Paths are validated against an allowlist to avoid accessing unauthorized areas.
• No arbitrary code execution is permitted.
• API keys are managed securely and are not exposed in plain responses.

Maintenance and troubleshooting

• Ensure prerequisites are installed and available in your system path.
• Check logs for errors if a tool fails to start or returns an error.
• Validate that the MCP runtime configuration references existing executables and valid arguments.
• Verify PiAPI and Brave Search keys are correctly configured when you plan to use AI and web-search features.

Advanced usage and notes

All PiAPI tools support automatic saving of generated content if an output directory is configured. Generated files are opened automatically with the system default application when possible.

Available tools

toolskit:list_allowed_directories

List all directories accessible by the server. No parameters required; returns a list of absolute paths to allowed directories.

toolskit:read_multiple_files

Read multiple files in parallel to improve throughput. Requires a paths array.

toolskit:search_files

Recursively search for files matching a glob pattern under a starting path. Requires path and pattern; optional excludePatterns.

toolskit:search_file_content

Search file contents for a regular expression starting at a given path. Requires path and regex; optional fileExtensions and excludePatterns.

toolskit:move_file

Move or rename a file or directory. Requires source and destination.

toolskit:directory_tree

Generate a YAML tree view of a directory. Requires path; optional recursive flag (default true).

toolskit:create_directory

Create a new directory, creating parents if necessary. Requires path.

toolskit:edit_file

Edit a file with precise edits. Requires path and edits array with oldText and newText.

toolskit:write_file

Create or overwrite a file with new content. Requires path and content.

toolskit:git_clone

Clone a Git repository. Requires repositoryUrl and targetDir; optional branch.

toolskit:git_commit

Commit changes in a repository. Requires workingDir and message; optional files and author.

toolskit:git_status

Show the status of the repository. Requires workingDir.

toolskit:git_pull

Synchronize with remote repositories. Requires workingDir; optional remote and branch.

toolskit:git_push

Push local commits to a remote repository. Requires workingDir; optional remote and branch.

toolskit:git_fetch

Fetch updates from a remote repository. Requires workingDir; optional remote and branch.

toolskit:git_checkout

Switch branches or create a new branch. Requires workingDir and branch; optional createBranch.

toolskit:git_diff

Show differences between commits. Requires workingDir, fromCommit, toCommit; optional files, unified, ignoreSpace, ignoreBlankLines.

toolskit:git_log

View commit history. Requires workingDir; optional maxCount, branch, file, from, to.

toolskit:git_resolve_conflicts

Resolve merge conflicts. Requires workingDir; optional operation (list or abort).

toolskit:brave_web_search

Perform web searches via Brave Search API. Requires query; optional count and offset.

toolskit:get_web_page_content

Retrieve content from a web page. Requires url.

piapi_text_to_image

Generate an image from text prompts. Optional model, width, height, negative_prompt, steps, guidance_scale, batch_size, and LoRA/ControlNet settings.

piapi_gemini_image_generation

Generate and edit images using Gemini 2.5 Flash Image. Requires prompt in English; supports multiple images, output format, and conversational inpainting/outpainting.

piapi_midjourney_imagine

Generate images via Midjourney. Requires prompt; optional aspectRatio.

piapi_derive_image

Create variations of an existing image. Requires prompt and referenceImage; optional width, height, negativePrompt, steps.

piapi_modify_image

Modify an image via inpaint or outpaint. Requires prompt and referenceImage; optional model, padding, negativePrompt, steps.

piapi_generate_image_controlnet

Generate with ControlNet. Requires prompt and referenceImage; optional controlType, lora, width, height, steps.

piapi_image_faceswap

Swap faces between two images. Requires swapImage and targetImage.

piapi_image_rmbg

Remove background from an image. Requires image.

piapi_image_segment

Segment an image with a description. Requires image and prompt; optional negativePrompt and segmentFactor.

piapi_image_upscale

Upscale image resolution. Requires image; optional scale and faceEnhance.

piapi_show_image

Display an image inline for images below a certain size. Requires url.

piapi_video_generation

Generate a video from prompts and key frames. Optional task_type, key_frames, model_name, duration, aspect_ratio, webhook_config.

piapi_generate_video_hunyuan

Generate video using Hunyuan models. Optional model, referenceImage, aspectRatio, negativePrompt.

piapi_generate_video_skyreels

Generate video via Skyreels. Requires prompt and referenceImage; optional aspectRatio and negativePrompt.

piapi_generate_video_wan

Generate video via Wan. Optional model, referenceImage, aspectRatio, negativePrompt.

piapi_generate_video_kling

Generate video via Kling. Optional referenceImage, aspectRatio, duration, negativePrompt.

piapi_generate_video_effect_kling

Apply Kling video effects. Requires image; optional effectName.

piapi_generate_video_luma

Generate video via Luma. Optional duration, aspectRatio, keyFrame.

piapi_video_faceswap

Swap faces in videos. Requires swapImage and targetVideo.

piapi_video_upscale

Upscale video resolution. Requires video.

piapi_music_generation

Generate music with optional lyrics. Supports model, task_type, lyrics_type, tags, negative_tags, prompt, make_instrumental.

piapi_extend_music

Extend existing music. Requires continue_clip_id and prompt; optional tags and negative_tags.

piapi_generate_music_suno

Generate music using Suno. Requires prompt; optional makeInstrumental, title, tags, negativeTags.

piapi_generate_music_for_video

Generate music for a video. Requires prompt and video; optional negativePrompt.

piapi_tts_zero_shot

Zero-shot text-to-speech. Requires genText and refAudio; optional refText.

piapi_image_to_3d

Convert an image to a 3D model. Requires image_path or image_url; optional seed, ss_sampling_steps, slat_sampling_steps, ss_guidance_strength, slat_guidance_strength.

piapi_get_task_status

Monitor the status of long-running tasks. Requires taskId; optional checkInterval.

toolskit:markdown_to_document

Convert Markdown to other formats such as DOCX, PPTX, or HTML. Requires content or inputPath; optional format, outputPath, templatePath, openAfterGeneration.

toolskit:npm_install

Install dependencies for a project. Requires workingDir.

toolskit:npm_build

Build a project. Requires workingDir.

toolskit:dotnet_tool

Operate on .NET solutions. Requires solutionFile; optional operation (RunTests).

toolskit:serialize_csharp

Analyze C# files. Requires path; optional options with accessibility, includeStatic, namespaceFilter.

toolskit:analyze_csharp_dependencies

Analyze C# dependencies. Requires filePath.

toolskit:get_current_datetime

Return the current date and time. No parameters.