rustypaste-mcp-server

Instructions

Implementation Reference

• src/tools/oneshot-file.ts:41-64 (handler)

  The handler function that executes the rustypaste_oneshot_file tool logic.

  async (params: Input) => {
      try {
          const client = new RustypasteClient();
          const result = await client.oneshotFile(params.file_path);
          return {
              content: [
                  {
                      type: "text" as const,
                      text: `✅ One-shot file uploaded!\n\n⚠️ This link will expire after a single view.\n\nURL: ${result.url}`,
                  },
              ],
          };
      } catch (error) {
          return {
              isError: true,
              content: [
                  {
                      type: "text" as const,
                      text: `Error: ${error instanceof Error ? error.message : String(error)}`,
                  },
              ],
          };
      }
  }

• src/tools/oneshot-file.ts:5-10 (schema)

  The input schema definition for the rustypaste_oneshot_file tool.

  const InputSchema = z.object({
      file_path: z
          .string()
          .min(1, "File path must not be empty")
          .describe("Absolute path to the file to upload as a one-shot"),
  });

• src/tools/oneshot-file.ts:14-65 (registration)

  The registration function that registers the rustypaste_oneshot_file tool with the MCP server.

  export function registerOneshotFile(server: McpServer): void {
      server.registerTool(
          "rustypaste_oneshot_file",
          {
              title: "One-Shot File Upload",
              description: `Upload a file as a one-shot link — it can only be viewed/downloaded once.
  
  After the first access, the file is automatically deleted from the server.
  Useful for sharing sensitive or temporary files securely.
  
  Args:
    - file_path (string): Absolute path to the file (e.g. "/home/user/secret.txt")
  
  Returns:
    The one-shot URL. The file will be deleted after the first download.
  
  Examples:
    - Share a secret: file_path="/tmp/credentials.txt"
    - One-time image share: file_path="/home/user/photo.jpg"`,
              inputSchema: InputSchema,
              annotations: {
                  readOnlyHint: false,
                  destructiveHint: false,
                  idempotentHint: false,
                  openWorldHint: true,
              },
          },
          async (params: Input) => {
              try {
                  const client = new RustypasteClient();
                  const result = await client.oneshotFile(params.file_path);
                  return {
                      content: [
                          {
                              type: "text" as const,
                              text: `✅ One-shot file uploaded!\n\n⚠️ This link will expire after a single view.\n\nURL: ${result.url}`,
                          },
                      ],
                  };
              } catch (error) {
                  return {
                      isError: true,
                      content: [
                          {
                              type: "text" as const,
                              text: `Error: ${error instanceof Error ? error.message : String(error)}`,
                          },
                      ],
                  };
              }
          }
      );